your-skill-name

Explain what this skill does and when the agent should activate it. Be specific — this is how the agent decides to load the skill. Include trigger phrases, context signals, and use cases.

SKILL.md

GitHub

Your Skill Name

When to Activate

Describe the exact conditions under which this skill should activate.

  • Explicit trigger: user asks for X
  • Implicit trigger: user is doing Y, which would benefit from X
  • Integration trigger: another skill is active and this one adds value

Core Behavior

Explain what the skill does step by step.

Step 1 — [First step name]

Describe what happens here.

Step 2 — [Second step name]

Describe what happens here.

Output Format

Show the expected output structure:

## [Skill Name] — [Context]

[Section 1]
...

[Section 2]
...

References

  • references/example.md — description of what this file contains

Anti-Patterns

List things this skill should never do:

  • Never generate X
  • Avoid pattern Y
  • Don't combine with Z without checking first