Skills Library

Reusable agent skills

Preview what each skill can do, inspect the markdown contract, then copy it or open the upstream source on GitHub.

5 skills available

Use Brain when an AI coding agent needs durable repo memory, compiled context, local retrieval, session enforcement, note history, and undo inside the project.

Use Plan to turn rough ideas into shaped execution plans through brainstorms, specs, runtime slices, and explicit source-of-truth modes.

Use Caveman to compress agent output across Claude Code, Codex, Gemini, Cursor, Windsurf, Cline, Copilot, and other agents while preserving technical accuracy.

Use Skill Creator when a repeated agent workflow should become a portable SKILL.md with triggers, rules, references, and scripts.

Use Review when the goal is to find bugs, regressions, missing tests, and unsafe assumptions before summarizing the diff.

contextready

Brain

Use Brain when an AI coding agent needs durable repo memory, compiled context, local retrieval, session enforcement, note history, and undo inside the project.

Source

Capabilities

  • Stores durable project memory in plain markdown
  • Compiles startup context with packet budgets and session reuse
  • Uses project-local SQLite retrieval for repo knowledge
  • Enforces verification and durable updates through sessions
  • Tracks note history and undo for Brain-managed markdown

Best used for

  • Long-running repo work
  • Reducing repeated project reorientation
  • Architecture-sensitive implementation
  • Capturing decisions and follow-ups after a change
memoryretrievalcontextsessions

SKILL.md

---
name: brain
description: Use when a repo needs Brain-managed memory, context retrieval, and session hygiene.
---

# Brain

Brain is a local-first memory, context, retrieval, and workflow layer for AI coding agents.

## When To Use

- You need repo-local memory instead of chat-history context.
- You need architecture notes, workflow rules, or durable project docs.
- You need a focused startup context packet.
- You need verification recorded with the session.
- You changed architecture, workflow, config, or durable project behavior.

## Install

```bash
curl -fsSL https://raw.githubusercontent.com/JimmyMcBride/brain/main/scripts/install.sh | sh
brain skills install --scope global --agent codex
```

## Workflow

1. Bootstrap or adopt the repo with `brain init --project .` or `brain adopt --project .`.
2. Validate with `brain doctor --project .`.
3. Run `brain prep --project . --task "<task>"` before substantial work.
4. Read the compiled context and linked docs that matter.
5. Run checks through `brain session run --project . -- <command>`.
6. Update durable notes with `brain edit` when behavior changes.
7. Finish with `brain session finish --project .`.

## Guardrails

- Prefer existing project notes over chat memory.
- Keep durable knowledge in AGENTS.md, docs, or .brain notes.
- Do not invent parallel memory systems.
- Brain does not replace roadmaps or issue trackers.