nova-skilllisted
Install: claude install-skill thiagopbraga/skills-space
# Escrevendo uma skill para o skills-space
## O modelo mental
Uma skill não é documentação. É **contexto que entra na cabeça do agente no momento
certo e some depois**. O agente carrega apenas a `description` de todas as skills o
tempo todo; o corpo só entra em contexto quando a descrição casa com a tarefa.
Isso define as duas responsabilidades, e elas são bem diferentes:
- **`description`** — precisa fazer o agente *decidir carregar*. É um problema de recall.
- **corpo** — precisa fazer o agente *acertar*. É um problema de instrução.
Quase toda skill que "não funciona" na verdade nunca foi carregada. Suspeite da
description antes de reescrever o corpo.
## Passo 1: confirme que precisa existir
Não escreva uma skill quando:
- o agente já acerta sem ela (teste antes: rode a tarefa sem skill nenhuma);
- é uma regra sempre-válida do repositório — isso é `CLAUDE.md`, não skill;
- é conhecimento de uso único — isso é uma mensagem, não skill.
Escreva quando existe um procedimento **repetível**, **específico do time** e que o
agente **erra sozinho**. Se você não consegue nomear o erro que ela evita, ainda não
há skill.
## Passo 2: escolha o bundle
Skills vivem dentro de um bundle, que é a unidade que o time instala:
```
plugins/<bundle>/skills/<sua-skill>/SKILL.md
```
Prefira sempre um bundle existente. Crie um novo só quando um time diferente for dono
das skills e o público for outro — bundle demais faz o time instalar cinco coisas em
vez de uma. Se criar, escreva també