second-brain-audit

Audit notes folders and agent memory files for stale or contradictory facts.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill second-brain-audit-az9713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: second-brain-audit
Source: https://github.com/az9713/claude-code-hooks-tutorial/tree/main/skills/.claude/skills/second-brain-audit
Command: npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill second-brain-audit-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Notes and agent memory files rot silently: facts stop being true, but nothing flags them, so assistants keep answering with outdated values. This Skill finds claims that have quietly stopped being true, separates contradicted facts from unsupported ones, and fixes the worst location so the rot stops recurring. ## Core Features & Use Cases - Claim-by-claim audit of always-loaded files: Reads whatever the agent loads every session (CLAUDE.md, MEMORY.md, system prompts) and checks every current-sounding claim against the freshest evidence in the notes. - Deterministic contradiction scan: A read-only Python script finds subjects answered with different monetary values across files, measures how many bullets are dated, and flags finished items still sitting in open lists. - State vs. event restructuring: Converts one agreed-upon page into a replace-on-update Current State section plus an append-only Log, and adds a write-path instruction so new facts land correctly. - Use Case: Your assistant quotes a client's old retainer because three files disagree and the stalest one is in CLAUDE.md. Run the audit to surface the contradiction, fix that one page, and change the write path so it does not recur. ## Quick Start Ask the assistant to audit your notes folder or memory files for stale facts and contradictions, then fix the single worst page it finds.

Frequently Asked Questions about second-brain-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find stale facts in my notes or second brain?▼

Run the audit on your notes folder to extract every current-sounding claim from the files your agent loads each session, then check each against the newest evidence. Contradicted claims are reported first, followed by unsupported ones.

How do I stop my AI assistant from giving outdated answers from memory files?▼

Audit the always-loaded file such as CLAUDE.md or MEMORY.md, since a stale fact there affects every session. Then split facts into a Current State section that gets replaced on update and an append-only Log for events.

Does the audit script modify my notes?▼

No, the audit.py script only reads and reports; it never writes to any file. Any restructuring happens separately, one page at a time, with a diff shown for your approval before anything is changed.

What kinds of contradictions can the scan detect?▼

The script detects subjects given different monetary values in more than one file, comparing recurring rates and one-time amounts separately. Lifecycle conflicts like a page saying launching while a log records cancellation require manual review, since no regex can judge them reliably.

Why does the audit report zero problems when my notes feel messy?▼

A zero is not a clean bill of health: the script can only compare monetary values, so notes without money are largely invisible to it. It prints a coverage warning in that case, and the manual claim-by-claim audit still applies.

Can I use this with daily notes or non-markdown tools like Notion?▼

Yes, daily notes are treated as a correct event log; the fix is adding one file holding current values, not restructuring the journal. For non-markdown tools, the state-versus-event idea still applies but no files are restructured.