Skip to main content
Skills are reusable instruction packages that teach agents specific workflows. Store them in your repo at:
  • .agents/skills/ (recommended)
  • .claude/skills/ (also supported)
Each skill is a directory with a required SKILL.md, plus optional supporting files:
.agents
skills
deploy
SKILL.md
references
scripts
assets
  • SKILL.md: required instructions
  • references/, scripts/, assets/: optional
Agents get a list of available skills and selectively load relevant ones based on the task.

​
Example skill

.agents
skills
deploy
SKILL.md
scripts
deploy.sh
SKILL.md: 
# Deploy skill

Deploy the application to staging or production.

## When to use

- User asks to deploy, release, or push to staging/production

## Steps

1. Run `scripts/deploy.sh <environment>`
2. Verify deployment at the environment URL
3. Report success or failure

## When not to use

- For local development or testing
You can create skills manually or ask Build to scaffold them.