From gotrino-assistant
Surface documentation debt — stale READMEs, missing public API docs, broken internal links, undocumented env vars. Use when onboarding gets friction, before a release, or when an API has evolved without matching doc updates.
How this skill is triggered — by the user, by Claude, or both
Slash command
/gotrino-assistant:doc-debtThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Surface documentation that no longer matches reality, and public surfaces that were never documented.
Surface documentation that no longer matches reality, and public surfaces that were never documented.
"What would a new contributor misunderstand from our docs?"
Docs rot quietly. A version number that drifted from the manifest, a link to a wiki that was retired, a function parameter added to the code but never to the docs — each is small, but together they tell new contributors the project doesn't take its own documentation seriously.
Not a linter. The value is spotting divergence between docs and code, not formatting.
User may specify a file path, glob, or directory. If not specified, ask: "Which directory should I audit? (A README or a docs/ folder is typical.)"
Follow references/config-migration.md for preflight.
Read .assistant-config.md for:
/teach-charter)Glob for manifest files to find the canonical version number:
package.json — the version fieldpyproject.toml — [project] versionGemfile / Gemfile.lockgo.modCargo.toml — [package] versionUse this for version-drift checks.
Read the project's main README. Identify declared version, install commands, usage examples, linked resources. Note what the README claims is true.
For each signal in references/doc-debt-checklist.md:
](./ and ](../, verify targets exist.process.env, os.environ, ENV[ in source, cross-reference against docs.20\d\d) in changelogs and release notes.Organize by document (README, docs/api.md, etc.) or by source module where the gap lives.
references/doc-debt-checklist.mdreferences/debt-output-format.mdreferences/config-migration.mdFollow references/debt-output-format.md exactly.
Linters check formatting. This skill checks fidelity:
A doc with perfect markdown formatting and wrong facts is worse than a doc with imperfect formatting and right facts. This skill surfaces the former.
npx claudepluginhub hereinthehive/gotrino-assistant --plugin gotrino-assistantDetects documentation drift, stale references, and cross-document inconsistencies in projects. Scans code-doc mismatches, broken links, outdated versions, and git staleness.
Audits repository documentation for drift, stale statements, broken references, and README mismatches before corrective PRs.
Audits codebase documentation for accuracy, completeness, and freshness by comparing against code structure. Auto-fixes small discrepancies in fix mode, reports structural changes. Works with any language/framework.