Markdown Skill Creator

Step 1: Understand the Skill Purpose

Start with concrete examples of how the skill will be used:

Ask clarifying questions:

• "What types of tasks should this skill handle?"
• "Can you provide examples of user requests that should trigger this skill?"
• "What knowledge or guidance would be most valuable?"
• "Are there existing documents or guidelines to incorporate?"

Example scenarios:

• "Help me write code review feedback" → code-review-guidelines skill
• "Generate customer support response" → support-templates skill
• "Apply brand colors to this design" → brand-guidelines skill

Step 2: Choose the Right Pattern

Based on the skill's purpose, select an appropriate pattern:

Available Patterns:

1. Guidelines & Standards - Style guides, brand guidelines, conventions
2. Workflow & Process - Multi-step procedures with decision points
3. Template Collection - Reusable output formats and structures
4. Domain Knowledge - Schemas, reference data, business logic
5. Principle-Based Guidance - Design philosophy, quality frameworks
6. Multi-Variant Reference - Supporting multiple frameworks or platforms

For detailed pattern templates: See references/patterns.md

Quick Selection Guide:

• Single set of standards? → Pattern 1 (Guidelines & Standards)
• Multi-step process? → Pattern 2 (Workflow & Process)
• Multiple output formats? → Pattern 3 (Template Collection)
• Large reference knowledge? → Pattern 4 (Domain Knowledge)
• Flexible guidance + quality criteria? → Pattern 5 (Principle-Based)
• Same concept, multiple variants? → Pattern 6 (Multi-Variant)

Step 3: Design the Structure

Simple Skills (under 500 lines):

skill-name/
└── SKILL.md (all content)

Skills with Progressive Disclosure:

skill-name/
├── SKILL.md (core guidance + navigation)
└── references/
    ├── domain-1.md
    ├── domain-2.md
    └── domain-3.md

Skills with Templates or Assets:

skill-name/
├── SKILL.md (guidance + navigation)
├── templates/ or references/
│   └── [template files]
└── assets/ (optional)
    └── [resources used in output]

Progressive Disclosure Principle:

• SKILL.md: Core guidance, navigation (~2-5k words, <500 lines)
• references/: Detailed information loaded only when needed
• assets/: Resources used in output (templates, fonts, images)

Step 4: Write Effective Frontmatter

The frontmatter determines when your skill triggers. This is critical.

---