Skip to content
Back to skills

Docs Drift Check

ASecurity

Detecta referencias rotas en la documentación comparando las rutas entre backticks y los enlaces relativos contra el árbol real del repositorio.

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

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill docs-drift-check --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Docs Drift Check?

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

Security grade badge for Docs Drift Check
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-docs-drift-check/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-docs-drift-check)

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-drift-check
description: Detecta referencias rotas en la documentación comparando las rutas entre backticks y los enlaces relativos contra el árbol real del repositorio.
license: MIT
metadata:
  package: docs-sync-engine
  version: "1.1.0"
---

# Docs Drift Check

## Objetivo

Encontrar la documentación que cita ficheros que ya no existen, antes de que lo haga un lector.

## Instrucciones de ejecución

1. Comprueba la carpeta de documentación:

```bash
py docs-sync-engine/scripts/docs_drift.py --docs docs/ --root . --json
```

2. En CI usa `--fail-on high`: una referencia rota rompe el pipeline.
3. Excluye con `--exclude` las guías históricas que citan rutas antiguas a propósito.

## Qué revisa

| Origen | Ejemplo |
|---|---|
| Rutas entre backticks | `` `pkg/scripts/x.py` `` |
| Enlaces relativos | `[guía](../SKILL.md)` |
| Enlaces externos | Se ignoran |

## Límites

- Comprueba existencia, no contenido: un comando dentro del fichero puede estar obsoleto y seguir pasando.
- No resuelve anclas (`#seccion`) ni rutas absolutas de sistema.
- No corrige la documentación: señala fichero y línea para que se arregle.

## Gate de salida

- Cero referencias rotas o lista con su justificación.
- Los ficheros históricos excluidos quedan nombrados.
- La comprobación se puede repetir con el mismo comando.

## Handoff

Entrega a `docs-arch-gen` las rutas que cambiaron de sitio y a `docs-changelog` la nota de la corrección documental.

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.