---
title: Skills
description: Catálogo híbrido de skills, mirrors por client e validação.
context: Como criar, validar e sincronizar skills no projeto.
---

# Skills

Skills são instruções operacionais versionadas em `SKILL.md`. Elas complementam o fluxo SDD e também podem ser usadas fora dele quando o client oferece descoberta de skills.

## Fontes

| Fonte | Uso |
|---|---|
| `.agents/skills/<id>/SKILL.md` | Fonte preferencial para Codex e Antigravity |
| `.claude/skills/<id>/SKILL.md` | Mirror para Claude Code |
| `.cursor/skills/<id>/SKILL.md` | Mirror para Cursor |
| `.devin/skills/<id>/SKILL.md` | Mirror para Devin |
| `.opencode/skills/<id>/SKILL.md` | Mirror para opencode |
| `.trae/skills/<id>/SKILL.md` | Mirror para Trae |
| `plugins/orchestration/skills/<id>/SKILL.md` | Skills empacotadas no plugin |
| `templates/skill-catalog.yaml` | Catálogo canônico |

## Formato

O frontmatter permitido é:

```md
---
name: <skill-id>
description: <quando usar>
---
```

Evite metadados específicos de provider. O corpo deve ser operacional: objetivo, procedimento, regras, evidências e fallback.

## Comandos

```bash
sdd skills list --json
sdd skills doctor --strict
sdd skills validate .agents/skills/rust-project/SKILL.md --json
sdd skills sync --targets codex,claude,cursor,devin,opencode,trae,antigravity --dry-run
```

## Grupos

| Grupo | Exemplos |
|---|---|
| Centrais | `orchestration`, `project-discovery`, `risk-classifier`, `traceability` |
| Qualidade | `bdd-gherkin`, `code-review`, `test-strategy`, `security-privacy` |
| Stack | `rust-project`, `node-tooling`, `react-frontend`, `python-api`, `hono-api` |
| Design | `experience-design`, `frontend-design`, `visual-review`, `design-tokens` |
