Agent skill · writing content · yyh211
create-skill-file
Guides Claude in creating well-structured SKILL.md files following best practices. Provides clear guidelines for naming, structure, and content organization to make skills easy to discover and execute.
Why this skill is useful
Codifies best practices for creating SKILL.md files, which helps standardize the skill creation process for Claude.
What it needs
About 6k tokens when loaded. Last updated 2026-05-15. 274 stars on the source repository.
What this skill does
Claude Agent Skill Writing Guide How to create high-quality SKILL.md files Table of Contents Quick Start Core Principles File Structure Standards Naming and Description Standards Content Writing Guide Quality Checklist --- Quick Start 3 Steps to Create a Skill Step 1: Create Directory Step 2: Create SKILL.md Step 3: Test Use keywords from description in conversation to trigger Observe whether Claude executes correctly Adjust based on effectiveness --- Core Principles 1. Keep It Concise Only add new knowledge that Claude doesn't know: ✅ Project-specific workflows ✅ Special naming conventions or format requirements ✅ How to use custom tools and scripts ❌ General programming knowledge ❌ Obvious steps Example Comparison: 2. Set Appropriate Freedom Freedom Use Case Writing Approach --------- ---------- ------------------ High Requires creativity, multiple solutions Provide guiding principles, not specific steps Medium Recommended patterns but allow variations Provide parameterized examples and default flows Low Error-prone, requires strict execution Provide detailed step-by-step instructions or scripts Decision Criteria: Is there a clear "correct answer"? → Low freedom Does it need to adapt to different scenarios? → High freedom What's the cost of errors? → High cost = low freedom 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yyh211/create-skill-file-EN