Adding a Reusable Skill

Reference: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices

Agent Skills are modular capabilities that extend an AI agent's functionality. Each Skill packages instructions, metadata, and optional resources (scripts, templates) that the agent uses automatically when relevant.

Core principles (keep SKILL.md lean)

• Be concise: SKILL.md is loaded into context; every token competes with the user's request.
• Assume the agent is smart: only add context it wouldn't already know.
• Use progressive disclosure: keep detailed explanations and examples in references/*.md.

Naming + metadata

• name must be lowercase, numbers, hyphens only; prefer a clear action or domain name.
• description must be third-person, specific, and include "when to use".

Structure

• skills/<skill-name>/SKILL.md contains quick start, workflow, rules, and pointers to references.
• skills/<skill-name>/references/*.md holds extended explanations and examples.
• Keep references one level deep from SKILL.md (no nested references).