← ClaudeAtlas

knowledge-auditlisted

Audit the knowledge base for orphaned docs, stale docs, and unpromoted session learnings, and print a one-page health summary
ostin-pil/claude-plugins · ★ 0 · AI & Automation · score 73
Install: claude install-skill ostin-pil/claude-plugins
Produce a knowledge-health summary for the project so insights compound instead of scattering. The audit is three checks over the repo's tracked Markdown: orphaned docs (no other file references them), stale docs (no commit in N days), and unpromoted learnings (recent session logs whose decisions aren't reflected anywhere durable under the knowledge directory). The scan is `knowledge-audit.sh` (a shim over `knowledge-audit-impl.py`); this skill runs it, presents the report, and helps act on it. Read-only by default: it never deletes a flagged doc or promotes a learning on its own. ## Where the scan script lives `knowledge-audit.sh` ships inside this plugin's `bin/`, which Claude Code adds to the Bash tool's PATH while knowledge-kit is enabled. Invoke it by bare name, not through a repo path; do not expect a copy in the consuming project's `bin/`. ## Project configuration Read `.claude/lifecycle-manifest.md` first (resolve via `$(git rev-parse --show-toplevel)/.claude/lifecycle-manifest.md`). Where a step names a manifest key in `code font` (`knowledge_dir`, `research_dir`, `log_dir`, `audit_stale_days`), use that key's value. These keys are knowledge-kit's own; see the kit README and `manifest-keys.md` for the block to add to the manifest. A project that has not added them can pass the equivalents as flags. ## Arguments `$ARGUMENTS` is optional: - `--stale-days N` — override `audit_stale_days` for this run. - `--recent-logs N` — how many of the most recent session logs