CommunityEscrita e Ediçãogithub.com

rogerchappel/skill-drift-audit-skill

Audita o desalinhamento do SKILL.md em relação a documentos do repositório, scripts, exemplos e notas de versão.

O que é skill-drift-audit-skill?

Esta skill especializada permite que agentes de IA (como Claude Code, Cursor ou Codex) verifiquem se o arquivo `SKILL.md` de um repositório de skill de agente ainda reflete com precisão a documentação, scripts, exemplos e notas de versão do código real. Ela é útil durante revisões ou renovações de repositórios para garantir que a documentação da skill não esteja desatualizada (drift), mantendo a confiabilidade da skill para outros agentes. A skill funciona localmente, lendo arquivos do repositório e gerando relatórios de auditoria em formatos como Markdown ou JSON, sem modificar arquivos automaticamente ou chamar serviços externos, exigindo aprovação explícita para ações destrutivas. Ela suporta um fluxo de validação que inclui `npm run check`, `npm test` e `npm run smoke` para garantir a integridade da auditoria.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/skill-drift-audit-skill

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de Auditoria de Desalinhamento de Skill

Quando Usar

Use esta skill ao revisar ou atualizar um repositório de skill de agente e você precisar de evidências de que o SKILL.md ainda corresponde ao README, documentação, scripts do pacote, exemplos e notas de versão.

Entradas Necessárias

  • Um caminho de repositório local contendo SKILL.md.
  • Opcionalmente, README, documentação, metadados do pacote, changelog e notas de versão candidatas.

Limites de Efeitos Colaterais

scan lê arquivos locais e escreve relatórios em stdout. plan escreve apenas em um caminho explícito --output. A skill não deve reescrever SKILL.md, chamar serviços externos, publicar pacotes ou modificar artefatos de versão por padrão.

Requisitos de Aprovação

Peça aprovação explícita antes de editar instruções duráveis da skill, excluir exemplos, publicar pacotes ou enviar relatórios de auditoria para fora do workspace local.

Exemplos

skill-drift-audit scan . --format markdown
skill-drift-audit scan fixtures/stale-skill --format json
skill-drift-audit plan . --output tmp/skill-drift-plan.md

Fluxo de Validação

Execute estes comandos antes de confiar na skill:

npm run check
npm test
npm run smoke
npm run package:smoke

Habilidades Relacionadas