# Generated Docs Audit

> Audit generated HTML, Markdown, crawler controls, model-readable docs, structured data, API specs, and URL-class drift from one local source graph.

- Skill: `jmagly-ai-writing-guide/generated-docs-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jmagly-ai-writing-guide/generated-docs-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jmagly-ai-writing-guide/generated-docs-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: jmagly (https://skillmd.com/u/jmagly-ai-writing-guide)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jmagly-ai-writing-guide/generated-docs-audit

---


# Generated Docs Audit

Run the CI-friendly local auditor:

```bash
npm run docs:discoverability:audit -- --root <generated-site> --json
```

Use a reviewed `aiwg.docs-discoverability/v1` source graph. Treat failed crawl, index, or AI-discoverability controls as release blockers; review warnings for orphan, thin, stale, near-duplicate, and doorway-shaped output.

Do not present a local pass as hosted or multi-site governance. See `docs/guides/generated-docs-discoverability-audit.md` for the graph schema, severity rules, and public/enterprise boundary.