Skills
Skills are reusable instruction bundles that extend what an AI agent can do reliably.
Reference catalog: skills.sh
Why use skills
- standardize repeatable tasks
- reduce prompt duplication
- keep quality consistent across contributors
Example skills in this repository
pull_request_template- Uses
.github/pull_request_template.mdas the required PR structure.
- Uses
git_commit_instructions- Uses
.github/git_commit_instructions.mdto enforce conventional commit format.
- Uses
api-design- Reusable skill spec stored at
skills/api-design/SKILL.md.
- Reusable skill spec stored at
typescript-quality- Reusable skill spec stored at
skills/typescript-quality/SKILL.md.
- Reusable skill spec stored at
Call a skill in Claude Code
Use slash command style. For example:
/api-design
Interactive skill flow
Skill Interactive Flow
1Contract
2Implement
3Trigger
4Validate
Define Skill Contract
Set trigger and output so the skill has clear boundaries.
---
name: api-design
description: trigger when user requests endpoint/schema design
---Recommended pattern
- Keep each skill focused on one job.
- Link skill instructions to concrete files.
- Include explicit inputs, outputs, and constraints.
- Add examples for expected behavior.