Skip to content
Back to skills

Docs Sync Engine

ASecurity

Mantiene la documentación pegada al código: detecta referencias rotas, genera el borrador de arquitectura y arma el CHANGELOG desde los commits, de forma reproducible.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgo

Security analysis

A100/100

Pro scans all 17 files and shows the line behind each finding

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill docs-sync-engine --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Docs Sync Engine?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Docs Sync Engine
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-docs-sync-engine/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-docs-sync-engine)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: docs-sync-engine
description: Mantiene la documentación pegada al código: detecta referencias rotas, genera el borrador de arquitectura y arma el CHANGELOG desde los commits, de forma reproducible.
license: MIT
metadata:
  package: docs-sync-engine
  version: "1.1.0"
---

# Docs Sync Engine

## Propósito

Que la documentación no mienta: toda ruta citada existe, la arquitectura se regenera desde el árbol y el CHANGELOG sale de los commits, no de la memoria.

## Flujo

1. **Verificar** con `docs-drift-check`: cada ruta citada en la doc debe existir en el repositorio.
2. **Terminología** con `docs-terms`: glosario aceptado/rechazado y grafía canónica de cada término.
3. **Entorno** con `docs-env`: cada variable que lee el código aparece en `.env.example` y en la guía.
4. **Regenerar** con `docs-arch-gen`: la tabla de módulos y responsabilidades sale de los AST.
5. **Cerrar** con `docs-changelog`: agrupa los commits convencionales por versión.
6. **Comparar**: el borrador regenerado se revisa contra el documento vigente y solo se commitea lo que cambió de verdad.

## Sub-skills

| Sub-skill | Qué hace |
|---|---|
| `docs-drift-check` | Referencias de la doc frente al árbol: enlaces y rutas entre backticks |
| `docs-terms` | Glosario: términos rechazados y grafías canónicas |
| `docs-env` | Variables de entorno frente a `.env.example` y los docs |
| `docs-terms` | Glosario: términos rechazados y grafías canónicas |
| `docs-env` | Variables de entorno frente a `.env.example` y los docs |
| `docs-arch-gen` | Borrador de arquitectura desde docstrings y entradas |
| `docs-changelog` | CHANGELOG agrupado desde commits convencionales |

## Reglas

- La documentación se regenera, no se reescribe a mano: si el borrador difiere, manda el código.
- Un enlace roto es un fallo del repositorio, no una nota al pie.
- Todo documento generado lleva escrito el comando que lo regenera.
- Un término prohibido o una variable sin documentar es documentación rota, igual que un enlace.
- Un término prohibido o una variable sin documentar es documentación rota, igual que un enlace.

## Gate de salida

- Cero referencias rotas o cada una justificada.
- Documento de arquitectura regenerado y diff revisado.
- CHANGELOG de la versión generado desde los commits incluidos.

## Handoff

Entrega a `docs-drift-check` las rutas nuevas y a `docs-changelog` la versión publicada. Si un documento no se puede regenerar, se declara como manual y se anota el motivo.

Files in this skill

  • SKILL.md2.4 KB
  • docs-arch-gen/SKILL.md1.5 KB
  • docs-changelog/SKILL.md1.6 KB
  • docs-drift-check/SKILL.md1.4 KB
  • docs-env/SKILL.md2.1 KB
  • docs-terms/SKILL.md1.9 KB
  • scripts/arch_gen.py2.7 KB
  • scripts/changelog_gen.py3.9 KB
  • scripts/docs_drift.py3.5 KB
  • scripts/env_check.py5.5 KB
  • scripts/terms_check.py5.2 KB
  • skills.json1.1 KB
  • tests/test_arch_gen.py1.9 KB
  • tests/test_changelog_gen.py2.1 KB
  • tests/test_docs_drift.py2.1 KB
  • tests/test_env_check.py4.8 KB
  • tests/test_terms_check.py4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.