knowledge-base-health-check

name

knowledge-base-health-check

description

Audits a local Claude-managed knowledge base in Simon's '/Users/simon/Claude CoWork/Knowledge Base/' system. Surfaces contradictions between articles, broken backlinks, unsourced claims, stale articles, writing-rules violations, and three suggested new articles. Files a full report into the KB's 'Outputs/' folder, appends a one-line CHANGELOG entry, and (in interactive sessions) walks through which findings to action. Use this skill whenever the user says "run a health check", "audit the [name] KB", "audit my knowledge base", "check the wiki", "let's go through the health check report", or "action the latest health check". Also use when the monthly scheduled task 'knowledge-base-monthly-health-check' fires. Use this skill for any audit-style request against a folder under 'Knowledge Base/' even if the user doesn't say the word "health check" - the protocol is the same.

Knowledge Base Health Check Skill

This skill is the source of truth for the monthly knowledge base health check. The librarian reads it and follows it whenever a health check is invoked, on demand or via the scheduled task. The protocol is deliberately the same for both trigger paths so the output format is stable across runs.

When to invoke

Run this skill when any of the following happens: • The user says "run a health check", "audit the [name] KB", "check the wiki", or similar. or writes "/healthcheck" • The user says "action the latest health check" or "let's go through the health check report" - in that case, jump straight to Phase 2 using the most recent health-check report in the relevant KB's Outputs/ folder. • The monthly scheduled task fires it (taskld: knowledge-base-monthly-health-check ). If the user doesn't specify which KB, askl Don't run on every KB unless explicitly asked.

The two phases

The skill runs in two phases. Phase 1 always runs. Phase 2 runs only in interactive sessions - the scheduled task stops at the end of Phase 1.

Phase 1 — Audit and file (always)

1. Read the rules. Open About me/writing-rules. md and the per-KB CLAUDE.md for the KB being audited. The writing rules govern the writing-rules check; the per-KB rules govern Wiki structure and source provenance.