Contrato de Ativação
Use este skill após instalar, remover, criar, mover ou renomear skills, ou quando um delegador precisar de um índice de skills atualizado.
Regras Rígidas
- O registro é um índice, não um compilador ou resumo.
SKILL.mdpermanece a fonte da verdade. - Não gere nem injete regras compactas por padrão; preserve a intenção do autor passando caminhos exatos dos skills para subagentes.
- Sempre escreva
.atl/skill-registry.mdindependentemente do modo de persistência do SDD. - Salve o registro no Engram como
topic_key: skill-registryquando disponível, comcapture_prompt: false. - Ignore
sdd-*,_sharedeskill-registry; deduplique por nome do skill, preferindo skills de nível de projeto sobre skills de nível de usuário. - Adicione
.atl/ao.gitignorequando possível, a menos que explicitamente desabilitado.
Portões de Decisão
| Situação | Ação |
|---|---|
| Mesmo skill existe globalmente e no projeto | Manter o skill de nível de projeto |
| Mesmo skill existe em múltiplos locais globais | Manter a primeira fonte na ordem de varredura |
| Nenhum skill encontrado | Escrever um registro vazio para que os agentes parem de procurar às cegas |
| Agente delegará trabalho | Selecionar linhas correspondentes do registro e passar seus caminhos SKILL.md |
Passos de Execução
- Escaneie todos os diretórios de skills conhecidos do usuário e do projeto em busca de
*/SKILL.md. - Leia apenas o frontmatter conforme necessário para extrair o texto do gatilho
nameedescription. - Renderize
.atl/skill-registry.mdcom as fontes escaneadas, contrato de registro, nome do skill, gatilho/descrição, escopo e caminho exato. - Persista no Engram quando disponível usando
title: skill-registry,topic_key: skill-registry,type: configecapture_prompt: false. - Retorne o caminho do registro, contagem de skills, status do cache e se o Engram foi atualizado.
Contrato de Saída
Retorne:
- Nome do projeto e caminho de
.atl/skill-registry.md. - Número de skills indexados.
- Se o cache foi utilizado ou regenerado.
- Quaisquer skills ignorados ou duplicados, quando relevante.
Referências
docs/skill-style-guide.md— como os skills devem ser escritos antes da indexação.skills/_shared/skill-resolver.md— como os delegadores usam o índice.