Pular pro conteúdo

Writing For Agents skill

O Claude escreve e enxuga suas skills e o seu CLAUDE.md pensando em como o agente lê, pra ele achar a instrução e seguir o mesmo caminho toda vez.

por Matt Pocock

instalações
472,6 mil
estrelas no GitHub
303,3 mil
No skills.sh desde
julho de 2026
Licença
MIT

Atualizada no GitHub em 22 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

A skill é um guia de escrita pra qualquer documento que um agente lê: uma skill, um CLAUDE.md, um AGENTS.md ou um arquivo apontado por eles. Ela entra quando você cria ou edita skills ou mexe nesses arquivos, e o foco é fazer o agente seguir o mesmo processo toda vez.

Ela trata a descrição da skill e cada linha que aponta pra outro arquivo como um gatilho: o jeito de escrever decide quando o agente vai buscar o material. Ensina a separar passo de consulta, tirar pra outro arquivo o que só alguns casos usam e fechar cada passo com um critério claro de pronto.

Também traz uma faxina: cada informação num lugar só, nada de repetir o que o projeto já mostra, cortar frase que o modelo já obedece sozinho e dizer o que fazer em vez do que não fazer. Pra skill, um segundo arquivo explica o frontmatter e quando ela deve rodar só por comando.

Nas palavras de quem fez

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Matt Pocock, no SKILL.md

Quando usar

  • Escrever a sua primeira skill pro Claude Code
  • Enxugar um CLAUDE.md que cresceu demais e o Claude parou de seguir
  • Descobrir por que uma skill não é chamada quando deveria
  • Dividir uma skill grande em partes
  • Revisar as instruções de um projeto antes de passar pro time

Depois de instalar, é só pedir assim

  • Revisa o meu CLAUDE.md e corta o que o Claude já faz sozinho
  • Cria uma skill que monta minhas propostas comerciais, seguindo o guia de escrita pra agentes
  • Essa skill não está sendo chamada, reescreve a descrição dela

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Writing For Agents no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Writing For Agents, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que a writing-for-agents precisa pra funcionar?

Nada além do agente. São dois arquivos de texto, o guia e o da mecânica de skills, sem script, chave de API nem conta paga.

Ela escreve a skill por mim?

Ela orienta como escrever. Você pede a skill ou a revisão normalmente e o Claude aplica as regras do guia. Ela não roda a skill pra testar nem mede o resultado.

Roda no Codex e no Antigravity?

Roda: é um SKILL.md só de texto, e o guia vale tanto pro CLAUDE.md quanto pro AGENTS.md, o arquivo de instruções que o Codex lê.

Levar essa skill

1x writing-for-agentsR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/mattpocock/skills

Aprenda a usar

Mais da loja Matt Pocock

Ver a loja Matt Pocock