Skills

Skills

Skills are reusable capabilities that can be invoked by AI tools.

Location

.ai/skills/<skill-name>/SKILL.md

Format

Skills require YAML frontmatter with name and description:

---
name: deploy
description: Deploy the application to production
---

# Deploy Skill

## Steps

1. Run the test suite
2. Build the application
3. Deploy to production environment

## Commands

\`\`\`bash
pnpm test
pnpm build
pnpm deploy:prod
\`\`\`

Schema

{
  name: string; // Required
  description: string; // Required
}

Directory Structure

.ai/skills/
├── deploy/
│   └── SKILL.md
├── review/
│   └── SKILL.md
└── test/
    └── SKILL.md

Each skill directory can contain additional files if needed.

Export Mapping

Tool	Output
Claude Code	.claude/skills/<name>/ (symlink per skill)
OpenCode	.opencode/skills/<name>/ (symlink per skill)