| name | documentation-audit |
| description | Auditar consistencia documental, enlaces, estructura agents-first y seguridad antes de cerrar cambios. |
Skill: Documentation Audit
Usa esta skill cuando se modifiquen documentos, prompts, ejemplos, skills o la página estática del repositorio.
Entradas
- Archivos Markdown modificados.
- Archivos estáticos modificados.
- Objetivo del cambio.
Procedimiento
- Revisa que
AGENTS.md siga siendo breve, operativo y enlazado.
- Verifica que
README.md siga orientado a humanos.
- Comprueba que el prompt maestro no asuma stack ni agente específico.
- Revisa que
docs/agent/ conserve el set documental completo del ejemplo profesional.
- Confirma que las rutas mencionadas existan.
- Busca secretos, tokens o datos reales en ejemplos.
- Verifica que cualquier cambio relevante esté registrado en
docs/CHANGELOG.md.
Validaciones
- Ejecutar validación de enlaces Markdown.
- Revisar bloques de código Markdown.
- Servir el sitio por HTTP local si cambió
index.html o archivos en assets/ y pages/.
Resultado Esperado
Un resumen que indique:
- Documentos revisados.
- Problemas encontrados.
- Correcciones aplicadas.
- Validaciones ejecutadas.
