Agent skill

Meditate

by poteto in poteto/noodle

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/noodle --skill meditate -a claude-code

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

GitHub CLI
$ gh skill install poteto/noodle 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/noodle.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/

Facts

Skill name
meditate
GitHub stars
454
Token cost
~1.1k tokens
SKILL.md length
450 words
Files
3 (incl. scripts, references)
Skills in repo
26
Repo updated
First seen
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 Autonomous Session Mode, Process and Summary
  • Runs Shell scripts from its folder; calls sh

What it does

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

Its SKILL.md is about 1.1k 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: Orchestrate agents using skills. The licence is MIT.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “meditate”
  • “audit the brain”
  • “prune brain”
  • “/meditate”

Requirements

  • A Bash shell

Workflow steps

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

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 82d2921. 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 1.1k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 450 words of instructions outside code blocks.

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

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/noodle at commit 82d2921, republished under its MIT licence (© poteto). 450 words, ~1,083 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", "prune brain", "review skills", "consolidate notes", "prune notes".
schedule
Standalone single-stage order after several reflect cycles have accumulated. Expensive — don't over-schedule.

Meditate

Autonomous Session Mode

When running non-interactively (Cook, Oops, Repair):

  • Apply all high-confidence changes autonomously. For ambiguous or risky changes (brain file deletions, principle rewrites), file a todo instead.
  • Commit all changes with the /commit skill.

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

Use Tasks to track progress (TaskCreate per step, TaskUpdate to in_progress/completed).

1. Build snapshots
bash
sh <skill-path>/scripts/snapshot.sh brain/ /tmp/brain-snapshot.md
sh <skill-path>/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 § Auditor 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 § Reviewer 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. Audits description frontmatters for context bloat.
Show full SKILL.md (186 more words)Show less
4. Review reports

Present the user with a consolidated summary. See references/agents.md § Report Template for the 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 and pick a name that captures the combined insight
  • Bloated skill descriptions: Tighten frontmatter descriptions — cut what Claude can infer, keep only distinctive triggers and purpose
  • CLAUDE.md issues: Rewrite or delete
  • Stale memories: Delete or rewrite
7. Housekeep

Clean stale .noodle/ state (old debates, completed sessions, stale plan artifacts). 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]

© poteto, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

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

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

Open the folder on GitHubat commit 82d2921

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Meditate this skillpoteto/noodle454—~1.1kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

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.

    796 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

More from poteto/noodle

All 26 skills in this repo
  • Ruminate

    poteto/noodle

    Mine past Claude Code and Codex conversations for uncaptured patterns, corrections, and knowledge.

    454 GitHub stars~1.4k tokensUpdated 6 mo ago
    Auto-check passed
  • Ast Grep

    poteto/noodle

    Structural code search via ast-grep — use when code shape and element relationships matter, not just text.

    454 GitHub stars~531 tokensUpdated 6 mo ago
    Auto-check passed
  • Execute

    poteto/noodle

    Implementation methodology for executing tasks. An agent skill from poteto/noodle.

    454 GitHub stars~989 tokensUpdated 6 mo ago
    Auto-check passed
  • Noodle

    poteto/noodle

    Operate the Noodle CLI — explain commands, find flags, create/edit .noodle.toml config.

    454 GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Plan

    poteto/noodle

    Systematic planning for medium-to-large tasks. An agent skill from poteto/noodle.

    454 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • Quality

    poteto/noodle

    Post-cook quality gate. An agent skill from poteto/noodle.

    454 GitHub stars~774 tokensUpdated 6 mo ago
    Auto-check passed

Categories

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/noodle. 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/noodle --skill meditate -a claude-code`. Or copy the skill folder (.agents/skills/meditate in poteto/noodle) 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/noodle --skill meditate -a codex`. Or copy the skill folder (.agents/skills/meditate in poteto/noodle) 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/noodle --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 1.1k tokens (SKILL.md is roughly 4.3k 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/noodle, which has 454 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on March 19, 2026.

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