Docs Guard

Documentation drift is one of those silent killers in codebases, where the README still references a function you renamed three months ago and the getting started guide has broken imports. This skill runs as a verification pass after docs are written or changed. It checks every function name, flag, endpoint, and code sample against the actual source code, not what the model thinks the code probably looks like. The core insight is good: AI generates confident documentation whether or not the API exists. Use it reactively after a writing pass, not as a live editor. The rules are opinionated but grounded in real drift patterns, like demanding that performance claims point to actual benchmarks in the repo.

skills.sh installs: 4.1K
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add amelnagdy/guard-skills --skill docs-guard --agent claude-code

Installs into .claude/skills of the current project.

Files

Docs Guard

You are reviewing generated or changed documentation before it ships. Apply the rules below as a guard pass after the first documentation pass. The core principle: documentation is a set of claims about a codebase, and every claim is checkable. Your job is to check them.

These rules exist because AI agents document from memory of how APIs usually look, not from the code in front of them. Published research: half of AI answers to programming questions contain incorrect information, and models produce valid invocations for infrequent APIs barely a third of the time — yet the prose sounds authoritative either way. Readers cannot tell verified docs from hallucinated docs. You can, because you have the source.

How to use this skill

Guard-pass mode (recommended): after documentation or docstrings have been generated or edited, verify every claim against the source and run the self-check before delivery.

Live mode (explicit): when the user invokes this skill before writing docs, verify before you write — read the actual implementation, then document what it does. Run the self-check before delivery.

SKILL.md on GitHub