# Docs

> Detect drift between markdown docs (README, docs/) and the actual codebase. Catches references to npm scripts that don't exist, scoped dependencies not in package.json, file paths in backticks that don't resolve on disk, and undocumented npm scripts. Use to audit documentation hygiene before a release or after a major refactor. Exits non-zero on findings. Run as `node ~/.claude/skills/dragoon/skills/docs/scripts/docs.js`.

- Skill: `dragoon0x/docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dragoon0x/docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dragoon0x/docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: dragoon0x (https://skillmd.com/u/dragoon0x)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dragoon0x/docs

---


# /docs

Detects drift between your documentation and your code.

## When to use

- Auditing docs before a release
- After a major refactor that may have invalidated examples
- The user says "check docs", "audit the README", "find stale references"

## Rules

- `docs-001` npm scripts referenced in docs that don't exist (`medium`)
- `docs-002` scoped dependencies referenced that aren't installed (`low`)
- `docs-003` file paths in backticks that don't exist on disk (`medium`)
- `docs-004` npm scripts that aren't documented anywhere (`low`)

Each finding includes the markdown file, line, column, snippet, message, and a fix.

## Run it

```
dragoon docs                       # all severities
dragoon docs --severity medium     # focus on the actionable ones
dragoon docs --json                # CI mode
```

## Exit codes

- `0` no drift
- `1` drift detected
- `2` bad usage