# Act Documentation Hygiene

> Improves documentation accuracy, discoverability, consistency, and Markdown quality while deferring to repository conventions.

- Skill: `fabioc-aloha/act-documentation-hygiene` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fabioc-aloha/act-documentation-hygiene`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fabioc-aloha/act-documentation-hygiene/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: fabioc-aloha (https://skillmd.com/u/fabioc-aloha)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fabioc-aloha/act-documentation-hygiene

---


1. Identify the document's audience, purpose, canonical source, maintenance
   owner when known, and relationship to nearby documentation.
2. Check claims against available evidence and distinguish current instructions
   from historical records, examples, and assumptions. Avoid documenting
   unverified behavior as fact.
3. Make the smallest coherent update that keeps terminology, links, headings,
   examples, and navigation consistent. Prefer concise, task-oriented prose.
4. Follow repository-specific structure, style, linting, and generated-file
   conventions when they exist; do not impose a generic format over them.
5. Validate rendered meaning and link targets when feasible. Report what was
   checked and defer unverified commands, environment details, or ownership
   decisions to the responsible project context.