ln-21-documentation-auditor

Name: ln-21-documentation-auditor
Author: levnikolaevich

520stars73forks

How to install ln-21-documentation-auditor?

levnikolaevich/claude-code-skills/ln-21-documentation-auditor

$npx -y skills add levnikolaevich/claude-code-skills --skill ln-21-documentation-auditor

Installs into the current project.

Summary

Audits documentation and code comments for structure, coverage, factual accuracy, and maintainability. Use for documentation trust reviews; not code, test, or architecture audits.

Files · 1

View on GitHub

SKILL.md

1	# Documentation Auditor
2
3	Goal: Audit documentation as a read-only evidence system: can a new contributor, operator, user, or coding agent find the right source, trust its claims, and act without hidden context? Review both standalone documents and code comments where they carry public or operational knowledge.
4
5	Execution contract: Treat the ordered checkbox workflow below as this skill's Definition of Done. Work through every item in order, and mark it complete only when its action and required evidence are complete. `N/A`, skipped, unavailable, or delegated items remain incomplete.
6	Before returning, apply this skill's verdict, decision, and approval rules to every incomplete item and prepend Checklist: X/Y complete<br>Incomplete: None \| section/item — reason; outcome impact; exact next action; list every incomplete item.
7
8	## Tool Routing
9
10	\| Need \| Preferred tool \| Use it when \| Fallback \|
11	\|---\|---\|---\|---\|
12	\| Document inventory and hierarchy \| Native file listing with narrow patterns \| Establishing documentation surfaces, generated areas, and navigation structure \| Repository tree and known entry documents \|
13	\| Links, repeated terms, claims, and contradictions \| Native text search, then focused reads \| Finding references, stale names, duplicated guidance, paths, commands, and configuration keys \| Manual cross-document comparison \|
14	\| Code and configuration truth \| Native code search, manifests, schemas, and direct file reads \| A document claims that a path, option, endpoint, behavior, or default exists \| Execute a safe inspection command when text is insufficient \|
15	\| Freshness and ownership \| Git log, blame, and diff \| Determining when a claim changed, whether a document tracks active code, or who owns a convention \| Current code and explicit ownership files \|
16	\| Commands and examples \| Shell in non-mutating or dry-run mode \| Verifying help text, command existence, config parsing, generated output, or example syntax \| Inspect command registration and tests; mark runtime proof unavailable \|
17	\| External facts \| Official documentation, specifications, and release notes \| A current external API, version, standard, or platform behavior affects correctness \| Primary-source web research; otherwise mark `UNVERIFIED` \|
18
19	Do not run commands that publish, migrate, deploy, write production state, or rewrite documentation. Generated caches are acceptable only when permitted and disclosed.
20
21	## Evidence Rules
22
23	\| Claim type \| Required evidence \|
24	\|---\|---\|
25	\| Repository path, symbol, command, configuration, endpoint, or default \| Current repository or safe command output \|
26	\| External API, version, standard, or compatibility statement \| Official source matching the relevant version \|
27	\| Count or coverage statement \| Reproducible query with scope and exclusions \|
28	\| Historical rationale \| Current decision record or history that still matches implementation \|
29	\| Recommendation \| A demonstrated reader failure, contradiction, maintenance cost, or operational risk \|
30
31	Absence of documentation is a finding only when a real audience needs the missing knowledge. A stale claim is more serious than a missing optional explanation because it directs readers toward incorrect action.
32
33	## Checklist
34
35	### 1. Establish Scope and Audiences
36
37	- [ ] Identify documentation entrypoints, public docs, maintainer docs, operational runbooks, generated references, examples, and code-comment surfaces in scope.
38	- [ ] Identify intended audiences and their concrete tasks: understand, install, configure, operate, troubleshoot, extend, or verify the system.
39	- [ ] Read applicable repository instructions and detect documentation ownership, generation commands, language policy, and source-of-truth conventions.
40	- [ ] Separate authored documents from generated, vendored, archived, temporary, and example content before scoring defects.
41	- [ ] Classify each target as entrypoint/index, reference, how-to, explanation, decision record, generated output, or example; prioritize canonical and claim-dense documents before navigation-only files.
42	- [ ] Define which code, configuration, schemas, tests, and external contracts can verify documentation claims.
43	- [ ] Keep the audit read-only and record any unavailable source, command, or environment as a limitation.
44
45	### 2. Check Structure and Discoverability
46
47	- [ ] Verify that the root entry document explains purpose, supported use, prerequisites, installation path, and navigation appropriate to its audience.
48	- [ ] Check hierarchy, headings, table of contents, local navigation, cross-links, anchors, and predictable placement of related material.
49	- [ ] Find broken, redirected, case-sensitive, or repository-relative links and verify that linked files and headings exist.
50	- [ ] Identify orphan

levnikolaevichPublisher · 19 listings

Preview

levnikolaevich/claude-code-skills

# Documentation Auditor

**Goal:** Audit documentation as a read-only evidence system: can a new contributor, operator, user, or coding agent find the right source, trust its claims, an

**Execution contract:** Treat the ordered checkbox workflow below as this skill's Definition of Done. Work through every item in order, and mark it complete onl

Before returning, apply this skill's verdict, decision, and approval rules to every incomplete item and prepend **Checklist: X/Y complete**<br>**Incomplete: Non

Repolevnikolaevich/claude-code-skills

LicenseMIT

TypeSkills

CategoryDocumentation

UpdatedJul 2026

Repo stars520

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

ln-21-documentation-auditor

520stars73forks

View on GitHub

How to install ln-21-documentation-auditor?

levnikolaevich/claude-code-skills/ln-21-documentation-auditor

$npx -y skills add levnikolaevich/claude-code-skills --skill ln-21-documentation-auditor

Installs into the current project.

Summary

Audits documentation and code comments for structure, coverage, factual accuracy, and maintainability. Use for documentation trust reviews; not code, test, or architecture audits.

Files · 1

View on GitHub

SKILL.md

1	# Documentation Auditor
2
3	Goal: Audit documentation as a read-only evidence system: can a new contributor, operator, user, or coding agent find the right source, trust its claims, and act without hidden context? Review both standalone documents and code comments where they carry public or operational knowledge.
4
5	Execution contract: Treat the ordered checkbox workflow below as this skill's Definition of Done. Work through every item in order, and mark it complete only when its action and required evidence are complete. `N/A`, skipped, unavailable, or delegated items remain incomplete.
6	Before returning, apply this skill's verdict, decision, and approval rules to every incomplete item and prepend Checklist: X/Y complete<br>Incomplete: None \| section/item — reason; outcome impact; exact next action; list every incomplete item.
7
8	## Tool Routing
9
10	\| Need \| Preferred tool \| Use it when \| Fallback \|
11	\|---\|---\|---\|---\|
12	\| Document inventory and hierarchy \| Native file listing with narrow patterns \| Establishing documentation surfaces, generated areas, and navigation structure \| Repository tree and known entry documents \|
13	\| Links, repeated terms, claims, and contradictions \| Native text search, then focused reads \| Finding references, stale names, duplicated guidance, paths, commands, and configuration keys \| Manual cross-document comparison \|
14	\| Code and configuration truth \| Native code search, manifests, schemas, and direct file reads \| A document claims that a path, option, endpoint, behavior, or default exists \| Execute a safe inspection command when text is insufficient \|
15	\| Freshness and ownership \| Git log, blame, and diff \| Determining when a claim changed, whether a document tracks active code, or who owns a convention \| Current code and explicit ownership files \|
16	\| Commands and examples \| Shell in non-mutating or dry-run mode \| Verifying help text, command existence, config parsing, generated output, or example syntax \| Inspect command registration and tests; mark runtime proof unavailable \|
17	\| External facts \| Official documentation, specifications, and release notes \| A current external API, version, standard, or platform behavior affects correctness \| Primary-source web research; otherwise mark `UNVERIFIED` \|
18
19	Do not run commands that publish, migrate, deploy, write production state, or rewrite documentation. Generated caches are acceptable only when permitted and disclosed.
20
21	## Evidence Rules
22
23	\| Claim type \| Required evidence \|
24	\|---\|---\|
25	\| Repository path, symbol, command, configuration, endpoint, or default \| Current repository or safe command output \|
26	\| External API, version, standard, or compatibility statement \| Official source matching the relevant version \|
27	\| Count or coverage statement \| Reproducible query with scope and exclusions \|
28	\| Historical rationale \| Current decision record or history that still matches implementation \|
29	\| Recommendation \| A demonstrated reader failure, contradiction, maintenance cost, or operational risk \|
30
31	Absence of documentation is a finding only when a real audience needs the missing knowledge. A stale claim is more serious than a missing optional explanation because it directs readers toward incorrect action.
32
33	## Checklist
34
35	### 1. Establish Scope and Audiences
36
37	- [ ] Identify documentation entrypoints, public docs, maintainer docs, operational runbooks, generated references, examples, and code-comment surfaces in scope.
38	- [ ] Identify intended audiences and their concrete tasks: understand, install, configure, operate, troubleshoot, extend, or verify the system.
39	- [ ] Read applicable repository instructions and detect documentation ownership, generation commands, language policy, and source-of-truth conventions.
40	- [ ] Separate authored documents from generated, vendored, archived, temporary, and example content before scoring defects.
41	- [ ] Classify each target as entrypoint/index, reference, how-to, explanation, decision record, generated output, or example; prioritize canonical and claim-dense documents before navigation-only files.
42	- [ ] Define which code, configuration, schemas, tests, and external contracts can verify documentation claims.
43	- [ ] Keep the audit read-only and record any unavailable source, command, or environment as a limitation.
44
45	### 2. Check Structure and Discoverability
46
47	- [ ] Verify that the root entry document explains purpose, supported use, prerequisites, installation path, and navigation appropriate to its audience.
48	- [ ] Check hierarchy, headings, table of contents, local navigation, cross-links, anchors, and predictable placement of related material.
49	- [ ] Find broken, redirected, case-sensitive, or repository-relative links and verify that linked files and headings exist.
50	- [ ] Identify orphan

levnikolaevichPublisher · 19 listings

Preview

levnikolaevich/claude-code-skills

# Documentation Auditor

**Goal:** Audit documentation as a read-only evidence system: can a new contributor, operator, user, or coding agent find the right source, trust its claims, an

**Execution contract:** Treat the ordered checkbox workflow below as this skill's Definition of Done. Work through every item in order, and mark it complete onl

Before returning, apply this skill's verdict, decision, and approval rules to every incomplete item and prepend **Checklist: X/Y complete**<br>**Incomplete: Non

Repolevnikolaevich/claude-code-skills

LicenseMIT

TypeSkills

CategoryDocumentation

UpdatedJul 2026

Repo stars520

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type