knowledge-auditlisted
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