my-skill

Use when [TRIGGER CONDITION — what causes someone to invoke this skill]. Handles [PRIMARY TASK]. Outputs [DELIVERABLE]. Keywords: [comma-separated discovery keywords]

SKILL.md

GitHub
<!-- Remove <SUBAGENT-STOP> unless this is a meta-skill (session-recap, self-improve, drift-check). --> <!-- <SUBAGENT-STOP>: skip this skill when running inside a subagent. --> <!-- <SUBAGENT-STOP/> -->

[Skill Display Name]

One-sentence mission: what this skill accomplishes and for whom.

When to use — [specific trigger: "after a multi-agent run", "before deploying", "when asked to audit X"] Inputs — $ARGUMENTS ([what the user passes]); [env vars or files consumed] Outputs — [concrete deliverables: files created, reports, commands run] Verification — [how to confirm the skill succeeded] Can update ~/.agentskills or ~/.claude? [YES with scope / NO — project work only]


Protocol

Step-by-step. Each step is a tool call or decision:

  1. [Step name] — [what to do]. Use [ToolName] with [specific args].
  2. [Step name] — [what to do].
  3. [Step name] — [what to do].

If [edge case], then [alternative path].


Output format

[SKILL NAME]: [scope or target]

[SECTION]:
- [item]

STATUS: PASS / FAIL / [domain-specific]

Rules

  • [Non-negotiable constraint 1]
  • [Non-negotiable constraint 2]
  • Never [anti-pattern].

See

  • [[rule-name]] — [why relevant]
  • [[skill-name]] — [relationship]
  • references/REFERENCE.md — [if you have a references/ subdir]