Every new session starts the same way: you paste your code review checklist again, re-explain your team’s API conventions again, walk the agent through the release process again. Forget once, and Claude Code falls back to generic habits.
A Skill ends the repetition. It’s a folder with one SKILL.md file that teaches Claude Code a repeatable task or a piece of standing knowledge. Claude reads the description and pulls the skill in automatically whenever it’s relevant, no manual invocation needed. This guide builds one from scratch in about 5 minutes.
What the full guide covers:
- What You’ll Need
- Step-by-Step Setup
- What Each Piece Does
- Verify the Installation
The commands, our own test notes, and the troubleshooting steps are in the full guide, which we keep up to date:
Top comments (1)
One thing that helps skills load reliably is writing the description as the situations it applies to, like 'reviewing a PR' or 'touching the payments module', rather than what the skill is. That wording is what Claude matches on. It also pays to split things: always-true rules like the formatter and the test command go in CLAUDE.md, and skills hold the heavier checklists that only matter sometimes, so they don't cost context on every turn.