serge-the-hedge/agent-skills

O que agent-skills faz?

~/Dev/agent-skills contém todas as habilidades que uso em projetos: as minhas e as de terceiros que utilizo como base. agent-skills link preenche ~/.claude/skills (Claude Code) e ~/.agents/skills (Codex) com links simbólicos para o repositório, de modo que uma habilidade editada em qualquer uma dessas pastas seja editada no repositório.

Onde uma habilidade pertence

• Habilidade de projeto (o próprio .agents/skills/ de um repositório, como verify-*): permanece nesse projeto. O restante deste arquivo trata das habilidades neste repositório.
• Minhas: skills/<nome>/.
• De terceiros: vendor/<upstream>/, obtidas de pstack, habilidades de Matt Pocock e good-css via agent-skills update. upstreams.ts define quais delas são vinculadas.
• Qualquer coisa nas pastas de agente que não seja um link simbólico para o repositório (blabla-*, synced/ do Claude, .system/ do Codex) pertence à ferramenta que o instalou, que também o atualiza.

realpath ~/.agents/skills/<nome> informa qual é a origem de uma habilidade.

Criando

Crie a habilidade em ~/Dev/agent-skills/skills/<nome>/SKILL.md; esse caminho tem precedência sobre os padrões do skill-creator e /automate-me. Depois execute agent-skills link. Se houver conflito, escolha outro nome.

Editando

Decida conforme a natureza da mudança:

• Uma preferência minha (estilo, padrões, como gosto de trabalhar) vai nas minhas próprias habilidades: estenda uma em skills/ ou crie uma. Meus arquivos nunca entram em conflito com atualizações de terceiros.
• Uma correção para algo que uma habilidade de terceiros faz de errado para mim vai diretamente em vendor/. Edições feitas em terceiros sobrevivem ao agent-skills update, mas cada uma pode gerar conflito quando o upstream mudar as mesmas linhas; portanto, mantenha-as pequenas. Após editar pstack, execute node ~/Dev/agent-skills/vendor/pstack/scripts/check-t3-native.mjs <nome> até que saia com código 0.

Removendo

Remova skills/<nome>/ para uma habilidade minha. Para uma habilidade de terceiros, pergunte-me primeiro: isso implica alterar upstreams.ts.

Finalizando

A tarefa estará concluída quando agent-skills link for bem-sucedido e cada alteração estiver em seu próprio commit em ~/Dev/agent-skills, com push:

• Prepare apenas os arquivos que você alterou (git add <caminhos>); outros agentes podem ter trabalho em andamento ali.
• Escreva a mensagem explicando por que a habilidade foi alterada.
• Faça push imediatamente após o commit.

Escrevendo

• O repositório é público, portanto escreva cada habilidade como texto público: exemplos genéricos, livres de nomes, caminhos e segredos dos meus projetos.
• Refira-se a outra habilidade pelo caminho completo: ~/.agents/skills/<nome>/SKILL.md. Um ../<nome> relativo quebra aqui, pois minhas habilidades e cada habilidade de terceiros estão em pastas diferentes.
• Para a redação em si, siga ~/.agents/skills/writing-for-agents/SKILL.md.

Execute agent-skills sem argumentos para ver seus comandos.