Criar uma skill

Uma skill é uma pasta com um arquivo SKILL.md, no padrão aberto agentskills.io. Ela fica em .claude/skills/<nome>/ dentro do projeto, e os agentes a usam quando a tarefa combina com a descrição.

Estrutura

.claude/skills/
└── relatorio-semanal/
    ├── SKILL.md          ← obrigatório
    └── modelo.xlsx       ← arquivos de apoio (opcional)

O SKILL.md

---
name: relatorio-semanal
description: Monta o relatório semanal de vendas a partir das planilhas em dados/. Use quando pedirem relatório, fechamento da semana ou resumo de vendas.
---

# Relatório semanal

1. Leia todas as planilhas em `dados/` da semana atual.
2. Some vendas por produto e por vendedor.
3. Compare com a semana anterior e destaque variações acima de 10%.
4. Gere `relatorios/AAAA-MM-DD.md` com uma tabela e três frases de resumo.

## Nunca
- Não altere as planilhas originais.

A description é o que importa mais: é por ela que o agente decide usar a skill. Diga o que faz e quando usar.

Dicas

• Uma skill, um trabalho. Prefira várias pequenas a uma enorme.
• Escreva passos verificáveis (“gere o arquivo X”, “rode o comando Y e confira Z”).
• Inclua o que nunca fazer: é o que evita os erros mais caros.

Skills que vêm com o Merlin

O Merlin instala em cada projeto as skills do tipo dele, por exemplo: revisao-de-codigo, testes-no-navegador, contratos-de-api, commits-e-prs, deploy, documentacao, seguranca, design-de-interface, landing-page, copy-de-lancamento, uso-da-marca, video-remotion. Você pode abrir qualquer uma em .claude/skills/ para ver como foi escrita.