Skill Title (Imperative Verb Form)

One paragraph: what this skill accomplishes and the value it provides.

When to Use

• Concrete scenario where an agent should activate this skill
• Another trigger condition
• A third use case

<!-- Note: The most important triggers should also appear in the description field above, since description is read during discovery (frontmatter only) before the full body is loaded. This section provides additional detail. -->

Inputs

• Required: Description of required input
• Required: Another required input
• Optional: Optional input with default (default: value)

Procedure

Step 1: Action Title

Context sentence explaining what this step accomplishes.

# Concrete command or code the agent can execute
example_command --flag value

Expected: What success looks like. Be specific -- file created, output matches pattern, command exits 0.

On failure: Recovery action. What to check, what to retry, when to abort.

Step 2: Next Action

Context for this step.

next_command

Expected: Specific success indicator.

On failure: Recovery action.

Validation

• First verification check
• Second verification check
• Third verification check

Common Pitfalls

• Pitfall name: Explanation and how to avoid it
• Another pitfall: Explanation and how to avoid it

Examples (Optional)

Short worked examples showing the skill in action. Keep inline examples brief; move extended or multi-variant examples to

references/EXAMPLES.md

.

Related Skills

• related-skill-name

  -- how it relates to this skill

• another-skill

  -- how it relates

<!-- Keep under 500 lines. Extract large examples to references/EXAMPLES.md if needed. -->