Agent skill

Meditate

Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities.

MITAuto-check passedAgent Workflows

Install Meditate

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/meditate .claude/skills/meditate && rm -rf skills-src

Use ~/.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/

Paste into Claude Code

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .claude/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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

$skill-installer install https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate

Type 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.

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/meditate .agents/skills/meditate && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .agents/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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.

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/meditate .cursor/skills/meditate && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .cursor/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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

$ gemini skills install https://github.com/poteto/brainmaxxing.git --path .agents/skills/meditate

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/meditate .gemini/skills/meditate && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .gemini/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate

Installs 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).

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/meditate .github/skills/meditate && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .github/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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.

skills CLI

$ npx skills add poteto/brainmaxxing --skill meditate -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install poteto/brainmaxxing meditate --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/poteto/brainmaxxing.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/meditate .opencode/skills/meditate && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "meditate" agent skill from https://github.com/poteto/brainmaxxing/tree/main/.agents/skills/meditate into .opencode/skills/meditate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meditate", 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: meditate
GitHub stars: 321
Token cost: ~858 tokens
SKILL.md length: 358 words
Files: 3 (incl. scripts, references)
Skills in repo: 5
Repo updated: Feb 27, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities.

Works in 7 steps: Build snapshots → Auditor (blocking — its report feeds… → Reviewer (after auditor completes) → …
Agent Workflows work in your project
SKILL.md covers Process and Summary
Runs Shell scripts from its folder; calls sh

What it does

Meditate is an agent skill from poteto/brainmaxxing. Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities. Triggers: "meditate", "audit the brain".

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/agents.md` and `scripts/snapshot.sh`).

It sits in Agent Workflows. The repository describes itself as: stupid simple persistent memory and skill improvement. The licence is MIT.

When your agent uses it

Agent Workflows work in your project

Example prompts

“meditate”
“audit the brain”
“/meditate”

Requirements

A Bash shell

Workflow steps

7 steps, taken from the step headings in SKILL.md.

Build snapshots
Auditor (blocking — its report feeds step 3)
Reviewer (after auditor completes)
Review reports
Route skill-specific learnings
Apply changes
Housekeep

What it can do on your machine

Read from SKILL.md and the folder at commit ec4d8e4. 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
Ships 1 file in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
- sh
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

Meditate loads about 858 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~49
When it runs · the whole SKILL.md, loaded when a task matches: ~858
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from poteto/brainmaxxing at commit ec4d8e4, republished under its MIT licence (© poteto). 358 words, ~858 tokens.

Download SKILL.mdSave it as .claude/skills/meditate/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: meditate
description: Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities. Triggers: "meditate", "audit the brain".

Meditate

Quality bar: A note earns its place by being high-signal (Claude would reliably get this wrong without it), high-frequency (comes up in most sessions or most tasks of a type), or high-impact (getting it wrong causes significant damage or wasted work). Everything else is noise. A lean, precise brain outperforms a comprehensive but bloated one.

Process

1. Build snapshots

bash

sh .agents/skills/meditate/scripts/snapshot.sh brain/ /tmp/brain-snapshot.md
sh .agents/skills/meditate/scripts/snapshot.sh .agents/skills/ /tmp/skills-snapshot.md

Files are delimited with === path/to/file.md === headers. Also locate the auto-memory directory (~/.claude/projects/<project>/memory/).

2. Auditor (blocking — its report feeds step 3)

Spawn general-purpose subagent. See references/agents.md for the full prompt spec. Inputs: brain snapshot, auto-memory path, CLAUDE.md path.

Audits brain notes, CLAUDE.md, and auto-memory for staleness, redundancy, low-value content, verbosity, and orphans. Returns a categorized report.

Early-exit gate: If the auditor finds fewer than 3 actionable items, skip step 3 and go directly to step 4.

3. Reviewer (after auditor completes)

Spawn one general-purpose subagent. See references/agents.md for the full prompt spec. Inputs: brain snapshot, skills snapshot, auditor report, brain/principles.md.

Combines three concerns in a single pass:

Synthesis: Proposes missing wikilinks, flags principle tensions, suggests clarifications.
Distillation: Identifies recurring patterns that reveal unstated principles. New principles must be (1) independent, (2) evidenced by 2+ notes, (3) actionable.
Skill review: Cross-references skills against brain principles. Finds contradictions, missed structural enforcement, redundant instructions.

Show full SKILL.md (148 more words)Show less

4. Review reports

Present the user with a consolidated summary. See references/agents.md for the report format.

5. Route skill-specific learnings

Check all reports for findings that belong in skill files, not brain/. Update the skill's SKILL.md or references/ directly. Read the skill first to avoid duplication.

6. Apply changes

Apply all changes directly. The user reviews the diff.

Outdated notes: Update or delete
Redundant notes: Merge into the stronger note, delete the weaker
Low-value notes: Delete
Verbose notes: Condense in place
New connections: Add [[wikilinks]]
Tensions: Reword to clarify boundaries
New principles: Only from the distillation section, only if genuinely independent. Write brain files and update brain/principles.md
Merge principles: Look for principles that are subsets or specific applications of each other — merge the narrower into the broader
CLAUDE.md issues: Rewrite or delete
Stale memories: Delete or rewrite

7. Housekeep

Update brain/index.md for any files added or removed.

Summary

## Meditate Summary
- Pruned: [N notes deleted, M condensed, K merged]
- Extracted: [N new principles, with one-line + evidence count each]
- Skill review: [N findings, M applied]
- Housekeep: [state files cleaned]

Files

SKILL.md and 2 other files (scripts, references) in .agents/skills/meditate of poteto/brainmaxxing.

SKILL.md
references/agents.md
scripts/snapshot.sh

Open the folder on GitHubat commit ec4d8e4

Compare with similar skills

Meditate 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.

Meditate compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Meditate this skillpoteto/brainmaxxing	321	—	~858	Automated safety check: Pass	MIT	7 mo ago
MCP Server Builderanthropics/skills	180k	63 repos	~2.3k	Automated safety check: Pass	Apache-2.0	yesterday
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official	38k	10 repos	~4.1k	Automated safety check: Notes	Apache-2.0	yesterday
Using Superpowersfarm-fe/farm	5.6k	35 repos	~1.4k	Automated safety check: Pass	MIT	17 days ago
Executing Plans Inlineobra/superpowers	297k	2 repos	~5.1k	Automated safety check: Pass	MIT	today
Skill CreatorAzure/azqr	795	89 repos	~8.2k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

MCP Server Builder
anthropics/skills
Official
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
180k GitHub starsUsed in 63 repos~2.3k tokens
Agent WorkflowsAuto-check passed
Hook Development for Claude Code Plugins
anthropics/claude-plugins-official
Official
Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.
38k GitHub starsUsed in 10 repos~4.1k tokens
Agent WorkflowsAuto-check: notes
Using Superpowers
farm-fe/farm
A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions
5.6k GitHub starsUsed in 35 repos~1.4k tokens
Agent WorkflowsAuto-check passed
Executing Plans Inline
obra/superpowers
Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.
297k GitHub starsUsed in 2 repos~5.1k tokens
Agent WorkflowsAuto-check passed
Skill Creator
Azure/azqr
Official
Create new skills, modify and improve existing skills, and measure skill performance.
795 GitHub starsUsed in 89 repos~8.2k tokens
Agent WorkflowsAuto-check passed
Claude Code Agent Development
anthropics/claude-plugins-official
Official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
38k GitHub starsUsed in 7 repos~2.8k tokens
Agent WorkflowsAuto-check passed

Questions about Meditate

What does Meditate do?

Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities. Meditate is an agent skill from poteto/brainmaxxing. Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities.

When should I use Meditate?

Meditate fits situations like: agent Workflows work in your project.

How do I install Meditate in Claude Code?

Run `npx skills add poteto/brainmaxxing --skill meditate -a claude-code`. Or copy the skill folder (.agents/skills/meditate in poteto/brainmaxxing) into .claude/skills/meditate in your project. Claude Code loads it when a task matches its description.

How do I install Meditate in Codex?

Run `npx skills add poteto/brainmaxxing --skill meditate -a codex`. Or copy the skill folder (.agents/skills/meditate in poteto/brainmaxxing) into .agents/skills/meditate in your project. Codex loads it when a task matches its description.

Can I use Meditate 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 poteto/brainmaxxing --skill meditate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/meditate, .gemini/skills/meditate, .github/skills/meditate and .opencode/skills/meditate in your project.

What does Meditate need to run?

Going by SKILL.md and its folder, Meditate needs a shell for the scripts in its folder and the command-line tools its instructions call (sh). Our summary lists: A Bash shell.

Does Meditate 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 Meditate 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Meditate use?

Meditate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Meditate use?

About 858 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Meditate?

Skills that share tags, products or a category with Meditate: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Meditate?

poteto (a GitHub user) maintains it in poteto/brainmaxxing, which has 321 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on February 27, 2026.

Source: poteto/brainmaxxing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Meditate

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Meditate

Process

1. Build snapshots

2. Auditor (blocking — its report feeds step 3)

3. Reviewer (after auditor completes)

4. Review reports

5. Route skill-specific learnings

6. Apply changes

7. Housekeep

Summary

Files

Compare with similar skills

Similar skills

More from poteto/brainmaxxing

Related

Questions about Meditate