← ClaudeAtlas

nova-skilllisted

Use quando alguém for criar, revisar ou corrigir uma skill deste marketplace — escrever um SKILL.md do zero, escolher o bundle certo, ajustar uma description que não está disparando, resolver erro do validador, ou publicar a skill para Cursor/Copilot/AGENTS.md.
thiagopbraga/skills-space · ★ 0 · AI & Automation · score 73
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é