From inkwell
Identifies outdated documentation by comparing git commit dates of docs and referenced source files from first 50 lines or config globs. Outputs staleness scores and recommendations.
npx claudepluginhub acostanzo/quickstop --plugin inkwellThis skill is limited to using the following tools:
Find documentation files that may be out of date relative to the source code they document. Outputs a staleness report with scores and recommendations.
Detects stale documentation including outdated status markers, old TODOs, and version lags using grep and file scanning. Useful for doc maintenance audits.
Detects documentation drift, stale references, and cross-document inconsistencies in projects. Scans code-doc mismatches, broken links, outdated versions, and git staleness.
Audits documentation staleness via git history and maintains quality with auto-fixes. Maps code paths to docs in $JAAN_DOCS_DIR. Use for reviewing or updating docs.
Share bugs, ideas, or general feedback.
Find documentation files that may be out of date relative to the source code they document. Outputs a staleness report with scores and recommendations.
/inkwell:staleIf .inkwell.json exists in the project root, read it to determine documentation paths. Use the configured output paths to locate doc files and the paths globs to identify which source files are related to which doc types.
If .inkwell.json does not exist, use defaults:
docs/CHANGELOG.mddocs/ARCHITECTURE.mdGlob all markdown files in the docs root (from config or default docs/). Also check for the changelog file and architecture file at their configured paths.
If no documentation files are found, report: "No documentation files found. Nothing to check for staleness."
For each documentation file:
Get doc modification date: Run git log -1 --format="%ci" -- <doc-path> to get the last commit date that touched this file. If the file is untracked, use its filesystem mtime.
Identify referenced source files: Read the first 50 lines of the doc. Look for:
src/auth.ts, lib/utils.py)paths globs from .inkwell.json to identify related source directories. For example, if a doc is at docs/reference/auth.md, look for source files matching the api-reference.paths globs that contain "auth" in their name.Get source modification dates: For each referenced source file that exists, run git log -1 --format="%ci" -- <source-path>.
Calculate staleness: If any referenced source file was modified after the doc file, the doc is potentially stale. Staleness score:
Output the report sorted by staleness score (most stale first):
Inkwell Staleness Report
========================
Very Stale (3):
docs/reference/auth.md
Last updated: 2026-01-15
Stale because: src/auth.ts changed 2026-03-20 (64 days newer)
Recommendation: Review and update API reference
Stale (2):
docs/guides/setup.md
Last updated: 2026-02-28
Stale because: package.json changed 2026-03-15 (15 days newer)
Recommendation: Check if setup steps are still accurate
Fresh (0):
docs/decisions/0001-use-postgresql.md — up to date
docs/reference/utils.md — up to date
Summary: 5 docs checked, 1 very stale, 1 stale, 0 mild, 3 fresh