your-skill-name

name: your-skill-name description: > Describe what this skill does, when to use it, and key technologies it covers. Write in natural prose that incorporates relevant keywords organically — avoid bare keyword lists or quoted trigger phrases. This description is the primary triggering mechanism — it determines whether the agent loads the skill. 50-200 words recommended.

Skill Title

One-line summary of what this skill enables an agent to do.

Scope

• [Specific scenario or task this skill covers]
• [Another concrete use case within scope]
• [Include enough detail that the agent can apply the skill confidently]

Out of Scope

• [Scenario better handled by a different skill or approach]
• [Out-of-scope task that looks similar but isn't]

Quick Reference

Core Workflow

Step 1: [First Action]

[Concise instruction — 1-2 sentences maximum.]

# Copy-paste-ready code example
example_command --with-real-flags

Step 2: [Second Action]

[Concise instruction.]

# Another complete, runnable example

Step 3: [Third Action]

[Continue as needed. Use numbered steps for sequential workflows, subsections for parallel concerns.]

[Domain-Specific Section]

[Add sections as needed for your skill's domain. Use tables for decision matrices, comparison charts, or option lists. Use code blocks for patterns the agent should copy. Keep prose minimal — prefer structured formats.]

Anti-Patterns

Troubleshooting

References

• references/detailed-topic.md — [What it covers]
• External documentation — [When to consult]