aicr-auditing-docs
Installation
SKILL.md
Auditing AICR Documentation
Overview
AICR's docs are mature and already well-structured: a persona split under
docs/ (user / integrator / contributor), a docs hub with glossary
(docs/README.md), ADRs in docs/design/, and a strong root README.md.
The recurring risk is not missing structure — it is duplication and
drift as features land. This skill is a repeatable audit, not a rewrite:
default to a findings report; only edit when explicitly asked.
When to Use
- Periodic doc health check, or before a release.
- After a large feature merges (new CLI flag, API endpoint, component, recipe field).
- When the same explanation appears in multiple files and you suspect drift.
- Not for: writing a single new doc (just write it, following the style
rules below), or generated content (
docs/conformance/,docs/user/container-images.md).