HumanLayer Skills: primeiro acertar a estrutura de instruções de CLAUDE.md

Para quem é

Use este repositório quando você já usa Claude Code e quer, com skills da HumanLayer, mudar as instruções do projeto ou acrescentar um laço de agente executável. Página oficial:

https://github.com/humanlayer/skills

Página do projeto:

https://humanlayer.dev/

Pré-requisito: Claude Code já está no local. As notas não escrevem outros clientes como superfície suportada; não amplie isso sozinho.

O caminho principal de instalação só está evidenciado até um comando nomeado: instalar improve-claude-md. O texto genérico mostra um marcador de nome de skill não dado; não copie o marcador nem invente outros argumentos --skill. As notas não escrevem o diretório em disco.

Primeira tentativa em 3 minutos

Instalação recomendada (grava arquivos de skill no local; confira primeiro o nome do repositório e da skill):

npx skills add humanlayer/skills --skill improve-claude-md

Se o comando falhar, pare. Depois do sucesso, execute /improve-claude-md no projeto. Ele reescreve CLAUDE.md com blocos <important if>, ou seja, altera um arquivo. Peça primeiro ao assistente como vai reescrever e quais parágrafos vai tocar; só permita gravar depois de confirmar.

Sinal de sucesso: o assistente escolheu esta skill, consegue explicar como <important if> melhora o cumprimento de instruções e não sobrescreveu CLAUDE.md antes da confirmação. Se começar a mudar outros arquivos, barre.

As notas não escrevem passos de chave nem de conta extra.

Casos de uso

Caso 1: Reescrever CLAUDE.md. Instale como acima e chame /improve-claude-md. O objetivo é aumentar o cumprimento de instruções com blocos <important if>. Na primeira vez pré-visualize só num projeto que já tenha CLAUDE.md; se o arquivo faltar, pare. Não invente um modelo vazio para sobrescrever.

Caso 2: Apertar props de um componente React. As notas dizem: apertar os tipos de prop para caminhos de código reais, não Storybook, testes ou estados só mock. Na primeira vez, faça apontar quais tipos são largos demais e altere os arquivos de tipo depois de confirmar. Não há comando de instalação nem de barra para esta capacidade; não invente um nome de skill para --skill.

Limites de uso

O caminho principal só está escrito como:

npx skills add humanlayer/skills --skill improve-claude-md

O gatilho só está evidenciado até /improve-claude-md. Não use um marcador de nome de skill que nunca foi dado.

Também escreve: construir skills dentro do repositório; um fluxo GitHub Actions coding-agent com iteração, mais arquivos prompt, memory e modelos de referência; e desenhar sensor, controller, actuator e disturbances por perguntas e respostas, depois virar componentes executáveis no local mais um fluxo temporizado. Nada disso tem comando de instalação ou de barra; não faça na primeira vez.

As notas não escrevem cobrança, alcance de idioma nem diretório em disco. Na primeira vez só pré-visualize a reescrita de CLAUDE.md; não pule para GitHub Actions. Itens sem base ficam desconhecidos; não invente operações nem nomes de skill.