inbrainfun/inbrain/maintain

Claude Code and agent skill by inbrainfun/inbrain

Trust tier 2
  • community
  • ext:[{"type":"hook","description":"Pre/post lifecycle hooks"}]
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Brain health checks: back-link enforcement, citation audit, filing validation, stale info detection, orphan pages, and benchmarks. Use when asked to check brain health, run maintenance, or audit quality.

Install

npx vskill@latest install inbrainfun/inbrain/maintain

Semi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard

SKILL.md

The same SKILL.md was published earlier as inbrainfun/inbrain/maintain.

Maintain Skill

Periodic brain health checks and cleanup.

Contract

This skill guarantees:

  • All health dimensions are checked (stale, orphan, dead links, cross-refs, backlinks, citations, filing, tags)
  • Each issue found has a specific fix action
  • Back-link iron law is enforced
  • Citation format is validated against the standard
  • Results are reported with counts per dimension

Phases

Autonomous path (v0.36.4.0) — when you want to reach a target score

If the user asks "get my brain to 90/100" or "fix what's broken", prefer the one-command loop over walking each dimension by hand:

bash
inbrain doctor --remediation-plan --json # preview what would run
inbrain doctor --remediate --yes --target-score 90 --max-usd 5

--remediation-plan prints a dependency-ordered list (sync before extract, embed after consolidate, etc.) with per-step est_seconds and est_usd_cost. --remediate walks the plan, submitting each step as a Minion job, re-checking score between every step. --max-usd N is a hard cost cap — submission refuses when the plan would exceed the cap (prevents synthesize loops from burning Anthropic credits unattended).

When the target score is unreachable for the brain (empty brain with no entity pages → graph_coverage caps at 70; unconfigured embedding key → caps at 60), the command bails with a list of what's missing rather than looping.

Use the per-dimension walk below (Phase 2 onward) when:

  • The user explicitly asks for a dimension-by-dimension audit
  • You're investigating why score is stuck below --remediate's ceiling
  • A specific dimension needs manual judgment that the auto path skips
Manual path
  1. Run health check. Check inbrain health to get the dashboard.
  2. Check each dimension:
Stale pages

Pages where compiled_truth is older than the latest timeline entry. The assessment hasn't been updated to reflect recent evidence.

  • Check the health output for stale page count
  • For each stale page: read the page from inbrain, review timeline, determine if compiled_truth needs rewriting
Orphan pages

Pages with zero inbound links. Nobody references them.

  • Review orphans: are they genuinely isolated or just missing links?
  • Add links in inbrain from related pages or flag for deletion
Dead links

Links pointing to pages that don't exist.

  • Remove dead links in inbrain
Missing cross-references

Pages that mention entity names but don't have formal links.

  • Read compiled_truth from inbrain, extract entity mentions, create links in inbrain
Link graph extraction

If link_count is 0 or low relative to page_count, run batch extraction:

bash
inbrain extract links --dir ~/brain

This scans all markdown files for entity references, See Also sections, and frontmatter fields, then creates typed links in the database.

Timeline extraction

If timeline_entry_count is 0, extract structured timeline from markdown:

bash
inbrain extract timeline --dir ~/brain
Dream cycle (v0.23): synthesize + patterns

inbrain dream runs the full 8-phase maintenance cycle:

lint -> backlinks -> sync -> synthesize -> extract -> patterns -> embed -> orphans

The two new phases consolidate yesterday's conversations into long-term memory:

Synthesize phase: reads transcripts from dream.synthesize.session_corpus_dir, runs a cheap Haiku verdict (cached in dream_verdicts) to filter routine ops sessions, then fans out one Sonnet subagent per worth-processing transcript. Each subagent writes reflections (wiki/personal/reflections/...), originals (wiki/originals/ideas/...), and people timeline entries. The orchestrator collects the slugs from subagent_tool_executions (NOT pages.updated_at — that would pick up unrelated writes) and reverse-renders each new page from DB → markdown on disk.

Patterns phase: runs after extract (so the graph state is fresh). Reads recent reflections within dream.patterns.lookback_days (default 30), runs a single Sonnet pass to surface recurring themes, and writes pattern pages to wiki/personal/patterns/<theme> when ≥dream.patterns.min_evidence (default 3) reflections support a pattern.

Quality bar (Iron Law for synthesis):

  1. Quote the user verbatim. Do not paraphrase memorable phrasings.
  2. Cross-reference compulsively: every new page MUST have at least one wikilink.
  3. Slug discipline: lowercase alphanumeric and hyphens only. NO underscores, NO file extensions.
  4. Edited transcripts produce NEW slugs (content-hash suffix changes) — never silently overwrite.

Trust boundary (`allowed_slug_prefixes`): the synthesis subagent runs with an explicit allow-list of write paths sourced from _brain-filing-rules.json's dream_synthesize_paths.globs. Even on prompt-injection success, the subagent cannot write outside that list. Trust comes from PROTECTED_JOB_NAMES — MCP cannot submit subagent jobs at all. Editing the JSON is the only way to add a new directory the synthesizer can write to.

Idempotency + privacy: transcripts are keyed by (file_path, content_hash), so re-running on the same content is a no-op. dream.synthesize.exclude_patterns (default ["medical", "therapy"]) filters out transcripts before any LLM call. Each entry is auto-wrapped as a word-boundary regex (e.g. medical matches "medical advice" but NOT "comedical"). Power users may pass full regex.

Cooldown: the cycle's spend cap. dream.synthesize.cooldown_hours (default 12) means at most ~2 synthesize runs per day under autopilot. The completion timestamp is stored in dream.synthesize.last_completion_ts and is written ONLY on successful runs (not on skipped/failed). Explicit --input / --date / --from / --to invocations bypass cooldown.

`--dry-run` semantics: runs the cheap Haiku significance filter (caches verdicts) but skips the Sonnet synthesis pass. NOT zero LLM calls.

Configure synthesize on a fresh brain:

bash
inbrain config set dream.synthesize.session_corpus_dir /path/to/transcripts
inbrain config set dream.synthesize.enabled true
inbrain dream --phase synthesize --dry-run --json # preview
inbrain dream # full 8-phase cycle

Invocation patterns:

bash
inbrain dream # full cycle
inbrain dream --phase synthesize # just synthesize
inbrain dream --phase patterns # just patterns
inbrain dream --input ~/transcripts/2026-04-25.txt # ad-hoc one transcript
inbrain dream --from 2026-04-01 --to 2026-04-25 # backfill range
inbrain dream --json # CycleReport JSON

Auto-commit deferred to v1.1: v1 writes files to brain_dir but does NOT git add / commit / push. Either commit yourself or let inbrain autopilot handle it. Parses - **YYYY-MM-DD** | Source — Summary and ### YYYY-MM-DD — Title formats. Note: extracted entries improve structured queries (inbrain timeline), not vector search.

Autopilot check

Verify autopilot is running:

bash
inbrain autopilot --status

If not running, install it:

bash
inbrain autopilot --install --repo ~/brain

Autopilot runs sync, extract, and embed in a continuous loop with adaptive scheduling. In v0.11.1+, autopilot dispatches each cycle as a single autopilot-cycle Minion job and supervises the worker child — one install step gives you sync + extract + embed + backlinks + durable job processing.

Fix a half-migrated install

A v0.11.0 install where the migration skill never fired leaves Minions partially set up: schema is applied, but ~/.inbrain/preferences.json doesn't exist, autopilot runs inline, host manifests still reference agentTurn. Repair:

bash
# Check migration status
inbrain apply-migrations --list
# Apply pending migrations (idempotent; safe on healthy installs)
inbrain apply-migrations --yes
# If host-specific handlers are flagged in ~/.inbrain/migrations/pending-host-work.jsonl:
# walk them per skills/migrations/v0.11.0.md + docs/guides/plugin-handlers.md,
# ship handler registrations in the host repo, then re-run apply-migrations.

Full troubleshooting guide: docs/guides/minions-fix.md.

Back-link enforcement

Check that the back-linking iron law is being followed:

  • For each recently updated page, check if entities mentioned in it have

corresponding back-links FROM those entity pages

  • A mention without a back-link is a broken brain
  • Fix: add the missing back-link to the entity's Timeline or See Also section
  • Format: - **YYYY-MM-DD** | Referenced in [page title](path) -- brief context
Filing rule violations

Check for common misfiling patterns (see skills/_brain-filing-rules.md):

  • Content with clear primary subjects filed in sources/ instead of the

appropriate directory (people/, companies/, concepts/, etc.)

  • Use inbrain search to find pages in sources/ that reference specific

people, companies, or concepts -- these may be misfiled

  • Flag misfiled pages for review or re-filing
Citation audit

Spot-check pages for missing [Source: ...] citations:

  • Read 5-10 recently updated pages
  • Check that compiled truth (above the line) has inline citations
  • Check that timeline entries have source attribution
  • Flag pages where facts appear without provenance
Tag consistency

Inconsistent tagging (e.g., "vc" vs "venture-capital", "ai" vs "artificial-intelligence").

  • Standardize to the most common variant using inbrain tag operations
Graph population (v0.10.3+)

The links and timeline_entries tables are the structured graph layer. Populate them periodically or after major imports:

  • inbrain extract links --source db — backfill structured links by walking pages

from the engine. Reads [Name](people/slug) / [Name](companies/slug) references and infers relationship types (attended, works_at, invested_in, founded, advises, mentions, source). Idempotent. Use --source fs --dir <brain> if you have a markdown checkout to walk instead.

  • inbrain extract timeline --source db — backfill structured timeline entries.

Parses - **YYYY-MM-DD** | summary lines from page content. Idempotent (DB UNIQUE constraint).

  • inbrain extract all --source db — both in one run.
  • inbrain graph-query <slug> --depth 2 — verify connectivity (use any well-known

entity slug as a probe).

  • inbrain stats — verify link_count > 0 and timeline_entry_count > 0 after extraction.
  • inbrain health — review link_coverage and timeline_coverage percentages

on entity pages (person/company). Below 50% means more extraction is needed.

Available link types (use with inbrain graph-query --type): attended, works_at, invested_in, founded, advises, mentions, source.

Going forward, every inbrain put call auto-creates and reconciles links via the auto-link post-hook (default on; disable: inbrain config set auto_link false). So link-extract is mostly a one-time backfill. timeline-extract should be re-run after bulk imports or content edits that add new dated entries.

Embedding freshness

Chunks without embeddings, or chunks embedded with an old model.

  • For large embedding refreshes (>1000 chunks), use nohup:

nohup inbrain embed refresh > /tmp/inbrain-embed.log 2>&1 &

  • Then check progress: tail -1 /tmp/inbrain-embed.log
Security (RLS verification)

Run inbrain doctor --json and check the RLS status. All tables should show RLS enabled. If not, run inbrain init again.

Schema health

Check that the schema version is up to date. inbrain doctor --json reports the current version vs expected. If behind, inbrain init runs migrations automatically.

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 96 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
143
Repository forks
126
7-day trend score
25

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Extension points

  • hookPre/post lifecycle hooks

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/inbrainfun/inbrain/maintain/badge)](https://verified-skill.com/skills/inbrainfun/inbrain/maintain)

Something wrong with this skill or its page? Tell us.