Designing Skills for Claude Code

Use this skill when creating new skills to ensure they are discoverable and useful.

Critical Insight

The name and description determine whether an agent will EVER use your skill. Get these wrong and the skill will sit unused while the agent struggles without it.

Skill Structure

skills/
└── skill-name/           # lowercase-with-hyphens, matches name in frontmatter
    └── SKILL.md          # The skill definition
    └── scripts/          # any executable scripts or tools go in this folder
        └── my-script.ts  # actual script

Frontmatter Format