Pular pro conteúdo

Improve Claude MD skill

O CLAUDE.md do projeto fica curto e dividido por situação, e o Claude para de ignorar justamente as regras que importam.

por humanlayer

instalações
2.500
estrelas no GitHub
5.459
No skills.sh desde
março de 2026
Licença
MIT

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

O que ela faz

O Claude Code avisa o modelo que o CLAUDE.md "pode ou não ser relevante". Quanto mais coisa sem relação com a tarefa, mais ele ignora, inclusive o que importa. A skill reescreve o arquivo pra contornar isso: cada regra vai num bloco <important if> que diz em que situação ela vale.

O que serve pra quase toda tarefa (o que é o projeto, o mapa das pastas, a tecnologia) fica solto no topo. Regras de teste, de API, de importação ou de estado ganham cada uma o seu bloco, com uma condição estreita, em vez de um "sempre que mexer em código" que vale pra tudo.

Na reescrita, ela corta o que o linter ou o formatador já garantem, troca trecho de código por caminho de arquivo e tira instrução vaga, como "siga boas práticas". Os comandos do projeto ficam todos, sem exceção, numa tabela.

Nas palavras de quem fez

improve a CLAUDE.md file using <important if> blocks to improve instruction adherence…

humanlayer, no SKILL.md

Quando usar

  • O Claude vive esquecendo uma regra que está no CLAUDE.md
  • O CLAUDE.md cresceu e virou um textão
  • Herdou um projeto com CLAUDE.md cheio de regra de estilo e trecho de código
  • Quer separar as regras de teste, de API e de banco por situação

Depois de instalar, é só pedir assim

  • Melhora o CLAUDE.md desse projeto com a improve-claude-md
  • Reescreve meu CLAUDE.md em blocos important if e me diz o que você cortou e por quê
  • O Claude não segue a regra de testes do CLAUDE.md, reorganiza o arquivo pra ele obedecer

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 Improve Claude MD 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 Improve Claude MD, 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 improve-claude-md precisa pra funcionar?

Só de um CLAUDE.md pra reescrever, do projeto aberto ou colado na conversa. Não pede chave de API, programa instalado nem conta paga: é um roteiro de como reorganizar o arquivo.

Roda no Codex e no Antigravity?

Dá pra usar, porque é um SKILL.md comum. Mas a técnica foi pensada no jeito como o Claude Code lê o CLAUDE.md; a skill não fala do AGENTS.md do Codex nem de outros agentes.

Ela apaga alguma coisa importante?

Os comandos do projeto nunca saem. O que sai é regra que o linter já cobre, trecho de código e instrução vaga. Mesmo assim, compare o arquivo novo com o antigo antes de substituir.

Levar essa skill

1x improve-claude-mdR$ 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/humanlayer/skills

Aprenda a usar

Mais da loja humanlayer

Ver a loja humanlayer