goromal/agent-skills

Use quando estiver prestes a editar, criar ou excluir uma habilidade de agente. Habilidades compartilhadas são originadas do repositório agent-skills; habilidades locais downstream permanecem em seu repositório proprietário.

O que é agent-skills?

Esta habilidade gerencia o ciclo de vida de habilidades de agentes de IA (como Claude Code, Cursor, Codex), organizando onde elas são instaladas, como editá-las, criá-las e excluí-las, tanto em contextos compartilhados quanto locais (downstream). Ela é útil porque unifica a administração de habilidades através de diferentes frameworks e repositórios, garantindo que as alterações sejam feitas na fonte correta (o repositório proprietário) em vez de em links instalados. A habilidade suporta Claude, Codex e outros agentes configuráveis através do gerenciador de pacotes Nix, utilizando um catálogo central (`catalog.nix`) para selecionar habilidades compartilhadas. As habilidades instaladas são gerenciadas pelo home-manager em diretórios como `~/.claude/skills/`, e o processo de edição, criação e exclusão é detalhado em passos claros no `SKILL.md`, incluindo integração com branches de recursos e atualização de locks do Nix.

Funciona com✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/editing-skills

Documentação

De onde vêm as habilidades instaladas

As habilidades de agente são instaladas pelo home-manager em ~/.claude/skills/, ~/.agents/skills/ e ~/.codex/skills/. Esses caminhos gerenciados apontam para o diretório de origem da habilidade. Edite o repositório proprietário em vez de um link instalado.

As fontes e recursos de habilidades compartilhadas residem no diretório agent-skills/skills/<nome>/ do workspace. O catálogo Nix em agent-skills/catalog.nix seleciona habilidades compartilhadas para os consumidores. Overlays downstream podem adicionar caminhos de habilidades locais através de sua própria configuração machines.claude.skills e machines.codex.skills; mantenha esses arquivos no repositório downstream.

Editar uma habilidade compartilhada

Edite seu diretório no checkout agent-skills do workspace.
Se a alteração também atualizar um consumidor, use o mesmo branch de recurso em ambos os repositórios. Adicione agent-skills ao workspace com addsrc agent-skills [email protected]:goromal/agent-skills.git se não estiver presente.
Teste a integração com anixpkgs usando uma entrada flake local temporária, se necessário. Antes de enviar, restaure a URL do branch de recurso remoto e bloqueie-a com nix flake update agent-skills.
Abra o PR do agent-skills e vincule-o ao PR do consumidor. Mescle o PR da fonte da habilidade primeiro, depois repin os consumidores para a revisão main mesclada.

Criar uma habilidade compartilhada

Adicione skills/<nome-da-habilidade>/SKILL.md em agent-skills; mantenha referências, exemplos, scripts e ativos ao lado dele.
Adicione { name = "<nome-da-habilidade>"; file = ./skills/<nome-da-habilidade>/SKILL.md; } ao catalog.nix. As entradas se aplicam a Claude e Codex por padrão; defina frameworks quando necessário.
Vincule recursos de suporte relativamente à pasta da habilidade e atualize os locks downstream.

Editar uma habilidade local downstream

Altere-a no repositório que possui o overlay ou módulo que contribui com o caminho da habilidade. Mantenha o diretório autocontido, incluindo referências. Sua configuração pode adicionar uma entrada { name, file } à opção de skills do framework.

Excluir ou substituir uma habilidade compartilhada

Remova sua entrada do catalog.nix e exclua sua pasta de origem, depois atualize os locks downstream. Para substituir uma habilidade compartilhada em uma máquina, liste seu nome em machines.agents.excludedSkills e adicione o caminho da habilidade local com esse nome no módulo downstream.