Neat-Freak Knowledge Closeout
KKKKhazix/khazix-skills
Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.
The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.
Install Brain Ingest
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mindmuxai/brain.md brain-ingest --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brain-ingest .claude/skills/brain-ingest && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .claude/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingestType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mindmuxai/brain.md brain-ingest --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/brain-ingest .agents/skills/brain-ingest && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .agents/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mindmuxai/brain.md brain-ingest --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/brain-ingest .cursor/skills/brain-ingest && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .cursor/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mindmuxai/brain.md.git --path skills/brain-ingest--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mindmuxai/brain.md brain-ingest --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/brain-ingest .gemini/skills/brain-ingest && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .gemini/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mindmuxai/brain.md brain-ingestInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/brain-ingest .github/skills/brain-ingest && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .github/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mindmuxai/brain.md --skill brain-ingest -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mindmuxai/brain.md brain-ingest --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mindmuxai/brain.md.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/brain-ingest .opencode/skills/brain-ingest && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "brain-ingest" agent skill from https://github.com/mindmuxai/brain.md/tree/main/skills/brain-ingest into .opencode/skills/brain-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "brain-ingest", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
brain-ingest- GitHub stars
- 566
- Token cost
- ~1k tokens
- SKILL.md length
- 566 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.
- Works in 5 steps: Break down the input → Place each knowledge point (see… → Decide between "create" and "update… → …
- Tasks that involve Agent memory
- SKILL.md covers Process and Principles
- Calls node
What it does
Brain Ingest is an agent skill from mindmuxai/brain.md. The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Agent memory. The repository describes itself as: A persistent, file-based memory layer for coding agents — give Claude Code, Codex & others a project brain (durable decisions, requirements, constraints) via a zero-dependency CLI. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Agent memory
Example prompts
- “/brain-ingest”
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 8064f33. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Brain Ingest loads about 1k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 566 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from mindmuxai/brain.md at commit 8064f33, republished under its Apache-2.0 licence (© mindmuxai). 566 words, ~1,046 tokens.
Download SKILL.mdSave it as
.claude/skills/brain-ingest/SKILL.md (or your agent's skills folder).- name
- brain-ingest
- description
- The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the `brain` CLI.
brain-ingest
This skill is about "turning scattered input into structured brain knowledge". The input can be a conclusion from a conversation, an external document, a piece of research, or the decisions behind a set of code changes. The goal is to land that knowledge in the right place, the right category, and the right structure — and to write it through the brain CLI so it is correct by construction.
Reach for this process not only when explicitly asked to "ingest" something. The brain is the project's persistent memory (see BRAIN.md), so trigger it proactively whenever knowledge crystallizes — a decision settled in discussion, a requirement or constraint agreed, an insight that will still matter in six months. Capture it as it surfaces rather than waiting to be told.
Every read and write below is a brain CLI subcommand (list-pages / read-page / read-root to read; create-page / update-truth / … to write). The command details and the category taxonomy live in the brain-page skill — read it before creating or modifying any page.
NEVER hand-edit any file under the brain directory. All reads and writes MUST go through the
brainCLI. Manual edits are unsupported and illegitimate. There is no validator and nothing at the file layer can catch a bad manual edit; correctness is guaranteed only by going through the CLI, so a hand edit silently breaks the brain's invariants.
Process
1. Break down the input
Split the input into individual atomic knowledge points. A knowledge point = one judgment / fact / decision that stands on its own. Ignore purely procedural chatter.
2. Place each knowledge point (see "Choosing where to write" in BRAIN.md)
- Changes the project's overall positioning / architecture / stack / roadmap → rewrite the corresponding root page with
brain update-root <slug>(background/architecture/flow/mindmap/stack/roadmap). - About a specific entity (a decision / concept / person / reference / sub-project) → create or update a page.
- It's common for one knowledge point to touch both — write to both sides.
Show full SKILL.md (249 more words)Show less
3. Decide between "create" and "update existing"
- First run
brain list-pages(andbrain read-page <id>on likely hits) to look for an existing page on the same topic. - Found → update it:
brain update-truth --id <id>(rewrites compiled_truth and appends a timeline entry atomically), orbrain append-timelinefor a new piece of evidence that doesn't change the conclusion. - Not found → create it: read the brain-page skill, then
brain create-page, then fill in the real understanding withbrain update-truth. - Avoid duplication: don't scatter one topic across multiple pages.
4. Write
- All writes go through the
brainCLI — see brain-page for exact commands. Never hand-edit frontmatter or timelines. - Root pages are rewritten wholesale via
update-root; they have no timeline. - Write the body in the user's working language; keep technical identifiers (ids, slugs, field names, paths) verbatim.
- Connect related pages explicitly with
[[page-id]].
5. Verify
The write commands reindex for you, and correctness is guaranteed by construction — there is no validator to run. To optionally confirm that every [[page-id]] resolves:
node <brain-page-bundle>/bin/brain.mjs lint-linksThe CLI makes "compiled_truth changed but the timeline entry was forgotten" structurally impossible; the only way to break it is a hand edit, which is why you must never make one.
Principles
- Prefer less but accurate. Only capture knowledge that still matters in six months and is hard to reconstruct from the code / git.
- Every compiled_truth rewrite carries its own timeline trace —
update-truthguarantees this, keeping the chain of evidence unbroken. - Keep the category boundaries clear — the taxonomy lives in the brain-page skill.
© mindmuxai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/brain-ingest of mindmuxai/brain.md.
Open the folder on GitHubat commit 8064f33
Compare with similar skills
Brain Ingest next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Brain Ingest this skillmindmuxai/brain.md | 566 | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills | 21k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Beads Task Memorygastownhall/beads | 28k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Reflect on Session Learningscursor/plugins | 11k | 5 repos | ~1.2k | Automated safety check: Pass | None | |
| MemPalace Memory SearchMemPalace/mempalace | 59k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Compound Learning WriterEveryInc/compound-engineering-plugin | 25k | — | ~2k | Automated safety check: Pass | MIT |
Similar skills
Beads Task Memory
gastownhall/beads
Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.
- Official
Reflect on Session Learnings
cursor/plugins
Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.
MemPalace Memory Search
MemPalace/mempalace
Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.
Compound Learning Writer
EveryInc/compound-engineering-plugin
Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.
Session History Search
slopus/happy
Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.
More from mindmuxai/brain.md
Brain Setup
mindmuxai/brain.md
Bootstrap the Open Project Brain Standard into the current project — prefer brain init (ensure BRAIN.md, scaffold empty brain brainRoot-aware, default-wire CLAUDE.md + AGENTS.md).
Brain Bootstrap
mindmuxai/brain.md
Seed a freshly-scaffolded brain with real project knowledge — on an existing (brownfield) project read the code, docs, and git log to draft the six root pages and capture key historical decisions…
Brain Page
mindmuxai/brain.md
Operating manual for reading and writing a project's brain — every read and write goes through the bundled zero-dependency brain CLI; never hand-edit brain files.
Related
Categories
Questions about Brain Ingest
What does Brain Ingest do?
The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI. md. The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.
When should I use Brain Ingest?
Brain Ingest fits situations like: tasks that involve Agent memory.
How do I install Brain Ingest in Claude Code?
Run `npx skills add mindmuxai/brain.md --skill brain-ingest -a claude-code`. Or copy the skill folder (skills/brain-ingest in mindmuxai/brain.md) into .claude/skills/brain-ingest in your project. Claude Code loads it when a task matches its description.
How do I install Brain Ingest in Codex?
Run `npx skills add mindmuxai/brain.md --skill brain-ingest -a codex`. Or copy the skill folder (skills/brain-ingest in mindmuxai/brain.md) into .agents/skills/brain-ingest in your project. Codex loads it when a task matches its description.
Can I use Brain Ingest in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mindmuxai/brain.md --skill brain-ingest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brain-ingest, .gemini/skills/brain-ingest, .github/skills/brain-ingest and .opencode/skills/brain-ingest in your project.
What does Brain Ingest need to run?
Going by SKILL.md and its folder, Brain Ingest needs the command-line tools its instructions call (node).
Does Brain Ingest access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Brain Ingest safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Brain Ingest use?
Brain Ingest is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Brain Ingest use?
About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Brain Ingest?
Skills that share tags, products or a category with Brain Ingest: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars), Reflect on Session Learnings (cursor/plugins, 11k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Brain Ingest?
mindmuxai (a GitHub organization) maintains it in mindmuxai/brain.md, which has 566 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 11, 2026.
Source: mindmuxai/brain.md on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.