Claude-skill-registry drift-check

Detect documentation drift (docs out of sync with code). Use after changes, periodically, or when something feels wrong. Returns severity-rated findings with specific fixes.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/drift-check" ~/.claude/skills/majiayu000-claude-skill-registry-drift-check && rm -rf "$T"

manifest: skills/data/drift-check/SKILL.md

Drift Check

Detect documentation rot by comparing code reality against documented expectations.

When to Use

After completing a feature or bug fix
Before starting work on unfamiliar area
When behavior doesn't match expectations
Periodically (weekly recommended)

Severity Levels

Severity	Areas	Action Required
🔴 Critical	Auth/RLS wrong, billing docs incorrect, schema mismatch	Fix immediately
🟠 High	Server action undocumented, invariant violated	Fix this session
🟡 Medium	Route missing from surfaces, stale checklist	Fix soon
🟢 Low	Minor description inaccuracy	Track

Check Categories

Server Actions vs Docs — Actions exist in code but not documented (or vice versa)
Routes vs User Surfaces — Routes exist but not in feature doc tables
Schema vs Data Model — Tables/columns don't match docs
RLS vs Permissions Docs — Policies undocumented or incorrect
Invariants vs Reality — Can't find code enforcing documented invariants
Workflow Steps vs UI — Documented steps don't match actual UI

Quick Check Commands

# Count server actions
find app/actions -name "*.ts" | wc -l

# Count routes
find app -name "page.tsx" | wc -l

# Recent migrations (verify reflected in docs)
ls -lt supabase/migrations/ | head -5

Output

## Drift Check Report — [date]

**Scope**: [full / feature-name]

| Severity | Count |
|----------|-------|
| 🔴 Critical | [n] |
| 🟠 High | [n] |
| 🟡 Medium | [n] |
| 🟢 Low | [n] |

### Issues Found
[For each issue: category, location, finding, remediation]

### No Drift Found
[Areas checked with no issues]

Detailed check procedures: See reference/check-procedures.md
Remediation templates: See reference/remediation-templates.md
Severity scoring matrix: See reference/severity-matrix.md
After finding drift: Run
```
/doc-update
```
to fix