Documentation Verification
Use this skill when a docs change needs evidence, not just a writing pass.
- Leverage native parallel subagent dispatch and 200k+ context windows where available.
Activation Conditions
Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.
- Reviewing docs before merge or release
- Checking README, setup, or config accuracy
- Verifying local links, commands, and code samples
- Confirming docs changed alongside user-facing behavior
Verification Workflow
- Confirm the docs cover the changed behavior.
- Check relative links and referenced files.
- Validate commands and snippets where feasible.
- Report missing coverage and stale claims explicitly.
Documentation Stack Reference
Inherit the shared stack from documentation-patterns: source-of-truth discovery, audience framing, structure selection, verification, and freshness checks. Keep this skill focused on final evidence checks instead of restating the full stack.
Cross-Client Portability
This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.
- GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the
workflow in project instructions when folder discovery is unavailable.
- Claude Code: keep the folder in a local skills directory or a compatible plugin source.
- Codex: install or sync the folder into
$CODEX_HOME/skills/documentation-verification and restart Codex after major changes.
MCP Availability And Fallback
Preferred MCP Server: None required
- Fallback prompt: "Use the Documentation Verification skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding."
- Do not claim an MCP operation was used when the active host does not expose it.
- Treat local files, tests, rendered outputs, logs, or screenshots as the fallback evidence path.
Anti-Patterns
- Writing for the author instead of the reader: It bakes in unstated context and leaves the actual audience unsure what to do next.
- Skipping concrete examples or commands: Abstract guidance is easy to approve and hard to apply correctly.
- Letting links, screenshots, or versions drift: Polished formatting does not help if the instructions are no longer true.
Verification Protocol
Before claiming "skill applied successfully":
- Pass/fail: The Documentation Verification output identifies audience, purpose, source of truth, and freshness requirements.
- Pass/fail: Shared documentation-stack guidance is referenced instead of duplicating another documentation skill.
- Pass/fail: Claims, links, commands, examples, and screenshots are verified or explicitly marked unverified.
- Pressure-test scenario: Apply the skill to a doc request with a stale command, missing owner, and conflicting audience.
- Success metric: Zero undocumented assumptions; every reader-facing claim is sourced or scoped.
Review Checklist
References & Resources
Documentation
Scripts
- Doc Link Check - Validate relative Markdown links across one file or an entire docs tree
Related Skills
- documentation-authoring: Use it when the workflow also needs drafting structured technical or product documents.
- documentation-patterns: Use it when the workflow also needs reusable documentation structures and templates.
- documentation-quality: Use it when the workflow also needs documentation review standards and quality gates.
- notion-docs: Use it when the workflow also needs Notion page and database publishing workflows.
1---
2name: documentation-verification
3version: "2.0"
4last_updated: 2026-09-08
5tags: [documentation, verification, docs, writing, quality]
6description: "Validate documentation before merging - check completeness, broken links, code example accuracy, and factual correctness. Use when reviewing docs for quality gates or running pre-merge doc validation."
7metadata:
8 source: https://skillmd.com/skills/practicalswan/documentation-verification
9---
10
11# Documentation Verification
12
13Use this skill when a docs change needs evidence, not just a writing pass.
14
15- Leverage native parallel subagent dispatch and 200k+ context windows where available.
16
17
18## Activation Conditions
19
20Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.
21
22- Reviewing docs before merge or release
23- Checking README, setup, or config accuracy
24- Verifying local links, commands, and code samples
25- Confirming docs changed alongside user-facing behavior
26
27## Verification Workflow
28
291. Confirm the docs cover the changed behavior.
302. Check relative links and referenced files.
313. Validate commands and snippets where feasible.
324. Report missing coverage and stale claims explicitly.
33
34## Documentation Stack Reference
35
36Inherit the shared stack from [documentation-patterns](../documentation-patterns/SKILL.md#shared-documentation-stack): source-of-truth discovery, audience framing, structure selection, verification, and freshness checks. Keep this skill focused on final evidence checks instead of restating the full stack.
37
38<!-- MCP:START -->
39
40<!-- PORTABILITY:START -->
41## Cross-Client Portability
42
43This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.
44
45- GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the
46 workflow in project instructions when folder discovery is unavailable.
47- Claude Code: keep the folder in a local skills directory or a compatible plugin source.
48- Codex: install or sync the folder into
49 `$CODEX_HOME/skills/documentation-verification` and restart Codex after major changes.
50
51<!-- PORTABILITY:END -->
52
53## MCP Availability And Fallback
54
55Preferred MCP Server: None required
56
57- Fallback prompt: "Use the Documentation Verification skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding."
58- Do not claim an MCP operation was used when the active host does not expose it.
59- Treat local files, tests, rendered outputs, logs, or screenshots as the fallback evidence path.
60
61<!-- MCP:END -->
62
63## Anti-Patterns
64
65- Writing for the author instead of the reader: It bakes in unstated context and leaves the actual audience unsure what to do next.
66- Skipping concrete examples or commands: Abstract guidance is easy to approve and hard to apply correctly.
67- Letting links, screenshots, or versions drift: Polished formatting does not help if the instructions are no longer true.
68
69## Verification Protocol
70
71Before claiming "skill applied successfully":
72
731. Pass/fail: The Documentation Verification output identifies audience, purpose, source of truth, and freshness requirements.
742. Pass/fail: Shared documentation-stack guidance is referenced instead of duplicating another documentation skill.
753. Pass/fail: Claims, links, commands, examples, and screenshots are verified or explicitly marked unverified.
764. Pressure-test scenario: Apply the skill to a doc request with a stale command, missing owner, and conflicting audience.
775. Success metric: Zero undocumented assumptions; every reader-facing claim is sourced or scoped.
78
79## Review Checklist
80
81- [ ] Public behavior changes are documented
82- [ ] Local links resolve
83- [ ] Examples and commands still make sense
84- [ ] Setup steps reflect current tool versions
85- [ ] README and CHANGELOG were updated when required
86
87## References & Resources
88
89### Documentation
90- [Validation Procedures](./references/validation.md) - Practical checks for links, examples, config, and coverage
91
92### Scripts
93- [Doc Link Check](./scripts/doc-link-check.py) - Validate relative Markdown links across one file or an entire docs tree
94
95## Related Skills
96
97- [documentation-authoring](../documentation-authoring/SKILL.md): Use it when the workflow also needs drafting structured technical or product documents.
98- [documentation-patterns](../documentation-patterns/SKILL.md): Use it when the workflow also needs reusable documentation structures and templates.
99- [documentation-quality](../documentation-quality/SKILL.md): Use it when the workflow also needs documentation review standards and quality gates.
100- [notion-docs](../notion-docs/SKILL.md): Use it when the workflow also needs Notion page and database publishing workflows.