wicked-brain

Universal code intelligence via LSP. Queries language servers for definitions, references, symbols, call hierarchies, hover info, and diagnostics. Auto-installs language servers when missing. Use when: "where is X defined", "who uses X", "what type is X", "list symbols in", "find symbol", "who calls X", "code diagnostics", "lsp health".

Synthesize wiki articles from brain chunks. Dispatches a compile subagent that identifies concept clusters in chunks and writes structured wiki articles with backlinks and source attribution. Use when: "compile the brain", "write wiki articles", "synthesize knowledge", "brain compile".

This skill should be used when the user says "configure brain CLI", "update CLAUDE.md from brain", "write brain orientation", or "regenerate brain config". Reads brain state and writes contextual instructions into the active CLI's agent config file. Run after onboarding, major ingests, or consolidation.

Multi-pass brain consolidation - archive noise, promote patterns, merge duplicates, build synonym map. Use when: brain needs maintenance, after significant ingestion, or reviewing consolidation_hint entries in log.jsonl.

Inspect, replay, or drop dead-lettered events from wicked-brain's bus subscriber. The auto-memorize subscriber consumes `wicked.garden.fact.extracted` and dead-letters events that exhaust their retry budget. Without this skill, those events sit untouched forever — a fixable handler bug silently loses every fact. Use when: "show DLQ", "replay dead letters", "what events failed", "drop dead letter", "memory subscriber DLQ", "stuck fact events".

Fill gaps in brain knowledge. Dispatches an enhance subagent that identifies thin areas and writes inferred chunks to expand coverage. Use when: "enhance the brain", "fill gaps", "brain enhance", "what's missing in the brain".

Archive or delete a memory (or any indexed document) by id or path. Removes the document from the FTS index and renames the file with an `.archived-{timestamp}` suffix so the data is recoverable. Use when: "forget this memory", "archive this", "drop this decision", "remove from brain", "brain forget".

Initialize a new digital brain. Creates the directory structure, brain.json, and config. Auto-triggered on first use of any brain skill when no config exists. Use when: "set up a brain", "create a brain", "brain init", or when any brain skill detects no config.

Store and recall experiential learnings (decisions, patterns, preferences, gotchas, discoveries) in the brain's memory system. Use when: "remember this", "store this decision", "recall what we decided", "what do I know about", "brain memory".

Migrate a flat brain at ~/.wicked-brain/ into the per-project layout at ~/.wicked-brain/projects/{name}/. Safe to run on already-migrated brains (no-op). Auto-invoked by wicked-brain:init when a flat brain is detected. Use when: "migrate my brain", "move brain to per-project layout", "I have an old ~/.wicked-brain brain", or when init detects a flat brain.

Answer questions by searching and synthesizing brain content. Dispatches a query subagent that searches, reads, follows links, and produces a cited answer. Use instead of Agent(Explore) or reading files directly for any conceptual question: "what does X do", "how does Y work", "explain Z", "tell me about W", "why does X happen", "give me context on Y", or any question that could be answered from indexed knowledge. Always try this before exploring the codebase manually.

Backfill synonym-expanded tags on chunks and memories that have fewer than 5 tags. Run periodically or as part of consolidation. Use when: "retag the brain", "expand tags", "backfill synonyms", "brain retag", "improve tagging".

Manage the brain's synonym map for search expansion. Add, remove, or review synonym mappings. Can also auto-suggest synonyms from search miss data and tag frequency analysis. Use when: "add synonym", "manage synonyms", "brain synonyms", "why can't I find X", "search isn't finding".

Surface relevant brain knowledge for the current prompt. Tiered routing - hot path for simple prompts, fast path for complex. Use when: starting a new topic/unfamiliar area, at the start of a work session, prompt would benefit from prior decisions/patterns/wiki.

Full project understanding - detect repo mode, scan, investigate 5 perspectives, extract symbols, ingest chunks, compile support wiki, configure CLI. Use when: onboarding a new project, re-onboarding after big changes, brain has no project wiki yet.

Capture session learnings - decisions, patterns, gotchas, discoveries - as brain memories before session ends. Use when: session/topic is wrapping up, before /clear or exit, user says capture what we learned.

Show brain health, stats, and orientation with progressive loading. Depth 0: summary. Depth 1: + topic distribution. Depth 2: full orientation. Use when: "brain status", "what's in my brain", "brain health", or when orienting at the start of a session.

Browse stored memories with filters on type, tier, and recency. Read-only — use wicked-brain:forget to archive or wicked-brain:consolidate to promote. Use when: "review my memories", "browse decisions", "what have I stored", "list recent gotchas", "brain review".

Pattern for batch operations that would otherwise fill context with repetitive tool calls. Detects the available runtime (Node, Python, shell), writes a script, runs it, and reports results. Used internally by other skills. Use when: any brain operation needs to process more than 5 files, run more than 10 API calls, or would otherwise burn context on repetitive operations.

Confirm or contradict a brain link, adjusting its confidence score. Increases confidence when a link is confirmed by evidence, decreases it when contradicted. Tracks evidence_count for audit purposes. Use when: "confirm this link", "contradict this connection", "adjust link confidence", "mark link as confirmed", "this link is wrong".

Ingest source files into the brain as structured chunks. Handles text files (md, txt, csv, html) deterministically and binary files (pdf, docx, pptx, xlsx, images) via LLM vision. Dispatches a subagent for the heavy lifting. Use when: "ingest this file", "add to brain", "learn from this document", "index this file", "brain ingest", "ingest this directory".

Check brain health and fix issues. Dispatches a lint subagent that runs deterministic checks (broken links, orphans, stale entries) and semantic analysis (inconsistencies, gaps, tag misalignment). Use when: "lint the brain", "check brain health", "brain lint", "find issues in the brain".

Read a chunk or wiki article from the brain with progressive loading. Depth 0: frontmatter + stats. Depth 1: + summary + headings. Depth 2: full content. Use when: "read this chunk", "show me the article", "brain read", following up from search results, or when needing to inspect brain content.

Search the digital brain for relevant content. A single CLI call for the common single-brain case; fans out to linked brains only when they exist. Use instead of Grep/Glob/Agent(Explore) for any open-ended search or exploration: "find X", "search for Y", "look for Z", "where is W used", "show me anything about X", "explore Y", "what files relate to Z". Only fall back to Grep/Glob for exact symbol or pattern lookup when the brain returns no results.

Manages the wicked-brain background server. Most callers should use `wicked-brain-call` directly — it auto-starts the server. This skill is for explicit lifecycle management: start, stop, status, or recovery from a stuck process.

Open the read-only brain viewer (Material-styled search + wiki browser) in the default web browser. Use when the user says "open the brain viewer", "show me the wiki", "open the brain in a browser", "open the UI", "launch the viewer", or similar. Also use when the user wants to explore a specific doc visually rather than through search tool calls — the URL supports deep-linking via `#<path>`. Works against any wicked-brain server on the local machine. If the server isn't running, auto-starts it before opening.

Check for and install wicked-brain updates. Compares installed version against npm registry, updates skills across all detected CLIs, and updates the server. Use when: "update wicked-brain", "check for brain updates", "wicked-brain:update", or periodically to stay current.