From matts-second-brain
Periodic brain hygiene: dedupe near-duplicate notes, flag stale file citations and contradictions, archive long-unused notes, and reindex. Use when the user says 'brain hygiene', 'consolidate the brain', 'clean up duplicate notes', 'find stale notes', or after a long burst of writing. Opt-in and dry-run by default.
How this skill is triggered — by the user, by Claude, or both
Slash command
/matts-second-brain:hygiene [--apply] [--category standards|decisions|lessons|apps|reviews|drafts][--apply] [--category standards|decisions|lessons|apps|reviews|drafts]This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Periodic consolidation so the brain stays trustworthy as it grows. Opt-in (not
Periodic consolidation so the brain stays trustworthy as it grows. Opt-in (not
auto-run; the nightly maintenance job may also invoke this). Dry-run by default —
report findings and propose changes, and only write when the user confirms or --apply
is passed. Never delete; archive instead.
Call brain_stats. Report totals by category and recent growth; note any category
ballooning or going stale.
Call brain_check_citations. For each flagged note, read it and decide:
brain_update with the corrected pathFor each category (Standards first), use brain_recall(category) and
brain_search_semantic to find notes covering the same ground. Propose merging each
pair into one canonical note: brain_update the survivor with the union of content,
then supersede the others with a reason. Present pairs for confirmation — never
auto-merge. (brain_remember already blocks new near-duplicates at write time; this
cleans up ones that predate that.)
Where two notes disagree, or a note contradicts current code (verify with Grep/Read
per the _discipline rule), surface it and propose the correction.
Notes unmodified for 6+ months that reference deprecated systems: propose archiving
(tag #archived or move to Drafts). Do not delete.
After any writes, call brain_sync_srag so semantic search reflects the changes.
A concise report: counts, proposed merges, stale citations, archive candidates. In
dry-run nothing is written; with --apply (or an explicit user yes) execute only the
confirmed changes, each as an auditable brain_update.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub wrxck/matts-second-brain