Transforme um documento em SKILL.md

O que o conversor escreve

Uma skill é uma pasta com um arquivo obrigatório, o SKILL.md. O arquivo começa com um bloco curto de YAML (o frontmatter) e continua com as suas instruções em Markdown. O formato aberto Agent Skills exige dois campos nesse bloco:

• name: de 1 a 64 caracteres, com letras minúsculas, números e hifens, sem começar nem terminar com hífen e sem dois hifens seguidos. Precisa ser igual ao nome da pasta.
• description: de 1 a 1.024 caracteres sobre o que a skill faz e quando usá-la.

O conversor monta o nome a partir do primeiro título do documento, rascunha uma descrição a partir da primeira frase, arruma os marcadores e acrescenta um título se o documento não tiver. Edite qualquer um dos campos; o arquivo se atualiza enquanto você digita. As regras da própria Anthropic acrescentam mais duas: o nome não pode conter "anthropic" nem "claude", e nenhum dos campos pode ter tags XML. O conversor verifica as duas.

Onde colocar o arquivo

• Claude (web e desktop): vá até Personalizar e depois Skills (Customize > Skills), clique em +, depois em Create skill > Upload a skill, e escolha o .zip. Ele traz a pasta com o SKILL.md dentro, no formato que o Claude pede. A execução de código precisa estar ativada.
• Claude Code: descompacte em ~/.claude/skills/ para você, ou em .claude/skills/ dentro de um repositório para todo mundo que o clonar.
• Codex, Cursor, OpenCode: cada um lê as pastas de skills de um lugar próprio; o guia de sincronização lista esses lugares.

Cada cópia que você coloca à mão é uma cópia que alguém vai ter que atualizar à mão. É esse trabalho que o AI Skill Pod assume.

Escreva uma descrição que a IA siga

A IA vê só o nome e a descrição de cada skill até achar uma que sirva para o pedido, então é a descrição que decide se a sua skill vai ser aberta. Três hábitos ajudam:

• Comece pelo que ela faz: "Rascunha respostas a pedidos de reembolso no tom do nosso suporte."
• Depois diga quando: "Use quando um cliente pedir reembolso, devolução ou estorno."
• Cite as palavras que as pessoas digitam: nomes de produtos, tipos de arquivo, os termos da própria equipe.