documentationlisted

Authors, audits, and maintains project documentation across CLAUDE.md / .claude/rules/, AGENTS.md, README.md, and Diátaxis docs/ trees (root + nested for monorepos). Four modes: init scaffolds a tiered docs setup from scratch; update detects drift (dead @imports, renamed commands, stale narrative) and incrementally refreshes via a Placement Resolver that pushes rules to the innermost-ancestor destination; readme writes or audits a README against the standard-readme spec; audit produces a documentation health report across every surface. Routes by kind: hard rules to CLAUDE.md, path-scoped patterns to .claude/rules/, narrative to docs/, marketing to README.md. Triggers on "init claude", "bootstrap docs", "scaffold CLAUDE.md", "update docs", "sync CLAUDE.md", "docs drift", "write a README", "audit our docs", "review the README", "Diátaxis", "/documentation".
mthines/agent-skills · ★ 4 · Data & Documents · score 80

Install: claude install-skill mthines/agent-skills

# Documentation Author, audit, and maintain project documentation across every surface that matters: the **agent hot path** (`CLAUDE.md`, `AGENTS.md`, `.claude/rules/`), the **human entry point** (`README.md`), and the **narrative tier** (`docs/`). This is the single home for "make our docs good" work — bootstrapping a new project, refreshing docs after a sprint, writing a README that converts readers into users, or auditing the whole estate for drift. > **This `SKILL.md` is a thin index.** Detailed authoring rules live in > `rules/*.md` and load on demand. Worked examples are in > `references/*.md`. Literal scaffolding skeletons are in `templates/*.md`. > Do not preload everything — load only what the current phase asks for. --- ## Mode Detection Parse `$ARGUMENTS` (first token) and route to one of four modes. A second token of `--auto` is a cross-cutting modifier (see below). | Mode | Default | Trigger | | --------- | ------- | -------------------------------------------------------------------------------------- | | `init` | | "init", "bootstrap", "scaffold", or `$ARGUMENTS == "init"` (no existing CLAUDE.md). | | `update` | **yes** | Default when a `CLAUDE.md` already exists. "update", "sync", "refresh", "drift". | | `readme` | | "readme", "write a README", "audit the README", or `$ARGUMENTS == "readme"`. | | `audit` | | "audit", "revie