CommunityRedacción y edicióngithub.com

skill-drift-audit-skill

Audita la desviación del archivo SKILL.md con respecto a la documentación del repositorio, scripts, ejemplos y notas de la versión.

¿Qué es skill-drift-audit-skill?

Esta habilidad está diseñada para desarrolladores y mantenedores de repositorios de agentes de IA (como Claude Code, Cursor o Codex) que necesitan verificar que su archivo `SKILL.md` refleje con precisión el estado actual del repositorio. Realiza un análisis de desviación (drift) comparando el contenido de `SKILL.md` contra fuentes autoritativas como README, documentación, scripts definidos en package.json, ejemplos y notas de la versión. Es compatible con múltiples formatos de salida (markdown, json) y proporciona un modo `scan` para inspección local y un modo `plan` para generar un informe de desviación en una ruta específica. La habilidad es segura por defecto: no modifica archivos ni llama a servicios externos sin aprobación explícita, lo que la hace ideal para integrarse en flujos de CI/CD o revisiones de pull request.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Auditoría de Desviación de Skill

Cuándo Usarla

Usa esta habilidad cuando estés revisando o actualizando un repositorio de agente-skill y necesites evidencia de que SKILL.md aún coincide con el README, la documentación, los scripts del paquete, los ejemplos y las notas de la versión.

Entradas Requeridas

  • Una ruta de repositorio local que contenga SKILL.md.
  • Opcional: README, documentación, metadatos del paquete, registro de cambios y notas de candidato a versión.

Límites de Efectos Secundarios

scan lee archivos locales y escribe informes en stdout. plan escribe solo en una ruta explícita --output. La habilidad no debe reescribir SKILL.md, llamar a servicios externos, publicar paquetes ni modificar artefactos de versión por defecto.

Requisitos de Aprobación

Solicita aprobación explícita antes de editar instrucciones de skill duraderas, eliminar ejemplos, publicar paquetes o enviar informes de auditoría fuera del espacio de trabajo local.

Ejemplos

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

Flujo de Trabajo de Validación

Ejecuta estos comandos antes de confiar en la habilidad:

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

Skills relacionados