New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Gbrain Advisor

by garrytan in garrytan/gbrain

Proactive "make the most of gbrain" coaching. An agent skill from garrytan/gbrain.

MITAuto-check passedProductivity & Automation

Install Gbrain Advisor

skills CLI
$ npx skills add garrytan/gbrain --skill gbrain-advisor -a claude-code

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

GitHub CLI
$ gh skill install garrytan/gbrain gbrain-advisor --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/garrytan/gbrain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gbrain-advisor .claude/skills/gbrain-advisor && 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
gbrain-advisor
GitHub stars
31k
Token cost
~1.3k tokens
SKILL.md length
621 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Proactive "make the most of gbrain" coaching. An agent skill from garrytan/gbrain.

  • Works in 5 steps: Read the findings, highest severity first. → Summarize the top 1-3 to the user in… → For each, show the fix.command_argv and… → …
  • Productivity & Automation work in your project
  • SKILL.md covers Contract, When to run, How to run it and What to do with the findings, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gbrain Advisor is an agent skill from garrytan/gbrain. Proactive "make the most of gbrain" coaching. Runs gbrain advisor on a cadence and pings the user with the top high-leverage actions for their brain: version drift, pending migrations, stalled jobs, low embed coverage, setup smells, and uninstalled brain skills. Read-only; always asks before fixing.

Its SKILL.md is about 1.3k 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 Productivity & Automation. The repository describes itself as: Garry's Opinionated OpenClaw/Hermes Agent Brain. The licence is MIT.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “make the most of gbrain”
  • “/gbrain-advisor”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read the findings, highest severity first.
  2. Summarize the top 1-3 to the user in their own channel/voice. Lead with any
  3. For each, show the fix.command_argv and ask whether to run it.
  4. If they say yes and the finding has a fix.dispatch_id, you may run it
  5. Never run a fix the user didn't approve.

What it can do on your machine

Read from SKILL.md and the folder at commit fc54831. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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

Gbrain Advisor loads about 1.3k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 621 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from garrytan/gbrain at commit fc54831, republished under its MIT licence (© garrytan). 621 words, ~1,285 tokens.

Download SKILL.mdSave it as .claude/skills/gbrain-advisor/SKILL.md (or your agent's skills folder).
name
gbrain-advisor
description
Proactive "make the most of gbrain" coaching. Runs `gbrain advisor` on a cadence and pings the user with the top high-leverage actions for their brain: version drift, pending migrations, stalled jobs, low embed coverage, setup smells, and uninstalled brain skills. Read-only; always asks before fixing.
version
1.0.0
triggers
what should I do to get more out of gbrain, is my brain set up right, gbrain advisor, advise me on my brain, weekly brain checkup
tools
advisor
mutating
false

gbrain Advisor

Convention: See skills/conventions/brain-first.md. This skill is the proactive voice of the brain — it tells the owner how to run it better.

Contract

This skill guarantees:

  • Read-only. gbrain advisor never mutates. It computes a ranked list of actions from existing brain state.
  • Print, never execute. You SHOW the user the findings and ASK before running any fix. The user owns every decision.
  • Bounded nagging. On a cadence, surface only what changed or what's critical; don't repeat an ignored low-severity item every run.

When to run

  • On demand when the user asks "how do I get more out of this brain?"
  • On a weekly cadence via the cron recipe below (even idle brains get a "here's how to run this better" ping).
  • Monthly, the advisor also surfaces the backup-coverage verdict (gbrain backup status — which knowledge repos have no git remote); relay any warn.

How to run it

bash
gbrain advisor --json

Exit code is the severity gate (E2): 0 clean, 1 warn, 2 critical. The JSON payload is { version, generated_at, worst, findings: [...] }. Each finding has:

  • severity — critical | warn | info
  • title — one-line why-it-matters
  • fix.command_argv — the exact command to fix it (a structured argv)
  • fix.dispatch_id — present when the fix is safe to run via --apply

What to do with the findings

  1. Read the findings, highest severity first.

  2. Summarize the top 1-3 to the user in their own channel/voice. Lead with any critical item (e.g. pending migrations).

  3. For each, show the fix.command_argv and ask whether to run it.

  4. If they say yes and the finding has a fix.dispatch_id, you may run it locally with an explicit confirm:

    bash
    gbrain advisor --apply <dispatch_id>

    --apply is local-only, runs the fix as a structured argv (no shell), and confirms first. Findings without a dispatch_id are not auto-runnable — run their fix.command_argv yourself after the user agrees.

  5. Never run a fix the user didn't approve.

Cron recipe (weekly checkup)

Install a weekly job via the cron-scheduler skill. Keep the prompt THIN — the job just reads this skill and runs the advisor:

  • Schedule: weekly, one quiet-hours-respecting slot (e.g. Monday 09:00 local).
  • Job prompt: Read skills/gbrain-advisor/SKILL.md and run gbrain advisor --json. If anything is critical or new since last run, ping me with the top items and the exact fix commands. Ask before fixing.
  • Idempotent: the advisor is read-only, so a double-fire is harmless.

The advisor records a local run history, so on each fire you can tell the user what is new since last run rather than re-listing everything.

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

Output Format

When you surface advisor findings to the user, lead with severity and keep it scannable:

🧠 gbrain checkup — 2 things worth your attention

CRITICAL  Schema migrations are pending.
          Fix: gbrain apply-migrations --yes   (want me to run it?)

WARN      gbrain 0.44 is available (you're on 0.43).
          Fix: gbrain upgrade
  • One block per finding, highest severity first.
  • Always show the exact fix command and ASK before running it.
  • If nothing is pressing, say so in one line ("brain looks healthy") — don't manufacture work.

When it fails

Follow the agent operator protocol for any gbrain error code, exit code, [AGENT] block or notice block. Specific to this skill:

  • A critical finding (pending migrations) carries a fix such as gbrain apply-migrations --yes: ask the user before running it; findings without a dispatch_id are not auto-runnable.
  • gbrain advisor cannot reach the brain (GBRAIN_DB_ACCESS marker): route to the db-repair skill instead of reporting "no findings".

Anti-Patterns

  • Running a fix without asking. The advisor is read-only by contract. Never run --apply (or any fix command) without the user's explicit yes.
  • Dumping the raw JSON at the user. Translate findings into their voice; lead with what matters.
  • Re-nagging ignored low-severity items every run. Use the "new since last run" delta; respect the user's prior non-action.
  • Treating info like critical. Only block/insist on critical findings (pending migrations). info is a gentle nudge.
  • Calling the MCP advisor op for workspace install state. Over MCP the advisor returns brain-state signals only; uninstalled-skill findings are a local-CLI concern.

© garrytan, MIT. 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/gbrain-advisor of garrytan/gbrain.

Open the folder on GitHubat commit fc54831

Compare with similar skills

Gbrain Advisor 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.

Gbrain Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gbrain Advisor this skillgarrytan/gbrain31k—~1.3kAutomated safety check: PassMIT
Agent Browserquran/quran.com-frontend-next1.9k40 repos~3.3kAutomated safety check: PassNone
Perform Tasktelegramdesktop/tdesktop33k2 repos~3kAutomated safety check: PassGPL-3.0
Dependency Watchtelegramdesktop/tdesktop33k—~2.2kAutomated safety check: PassGPL-3.0
Brave Searchbadlogic/pi-skills2.6k5 repos~592Automated safety check: PassMIT
Garden Inboxpaperclipai/paperclip99k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 40 repos~3.3k tokens
    Productivity & AutomationAuto-check passed

  • Perform Task

    telegramdesktop/tdesktop

    Resolve, start or resume, implement, review, test, and publish exactly one existing ai-tdesktop task by short slug or full dated id, including rare blocked retries and split-required results.

    33k GitHub starsUsed in 2 repos~3k tokens
    Productivity & AutomationAuto-check passed

  • Dependency Watch

    telegramdesktop/tdesktop

    Audit Telegram Desktop dependencies on freshly fetched origin/dev for releases and security fixes, including upstream lag and backport candidates in patched forks.

    33k GitHub stars~2.2k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 5 repos~592 tokens
    Productivity & AutomationAuto-check passed

  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    99k GitHub stars~1.1k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Continue

    telegramdesktop/tdesktop

    Continue autonomous Telegram Desktop development from the shared ai-tdesktop repository.

    33k GitHub starsUsed in 2 repos~9.4k tokens
    Productivity & AutomationAuto-check passed

More from garrytan/gbrain

All 47 skills in this repo

  • Correction Root-Cause Pipeline

    garrytan/gbrain

    Traces a factual error the user points out back to its source (a brain page, a memory file, SOUL.md or USER.md, or a hallucination) and fixes that source instead of just noting the correction.

    31k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

  • Company Knowledge Brain

    garrytan/gbrain

    Searches and writes a company-wide knowledge brain through the gbrain CLI, so durable decisions and facts about people, projects and history stay findable beyond one session.

    31k GitHub stars~875 tokensUpdated today
    Auto-check passed

  • Idea Ingest

    garrytan/gbrain

    Ingest links, articles, tweets, and ideas into the brain. An agent skill from garrytan/gbrain.

    31k GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Brain-Augmented Web Research

    garrytan/gbrain

    Sends what your notes already know about a topic to Perplexity, so the cited web search reports only what is new, such as entity updates or deal changes.

    31k GitHub stars~2k tokensUpdated today
    Auto-check: notes

  • Schema Unify

    garrytan/gbrain

    Migrate a brain from gbrain-base (or any pack) to gbrain-base-v2's 14-canonical-type taxonomy via gbrain onboard --check + the unify-types Minion handler.

    31k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

  • Skillpack Check

    garrytan/gbrain

    Run gbrain skillpack-check to produce an agent-readable JSON health report for the gbrain install.

    31k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Gbrain Advisor

What does Gbrain Advisor do?

Proactive "make the most of gbrain" coaching. An agent skill from garrytan/gbrain. Gbrain Advisor is an agent skill from garrytan/gbrain. Proactive "make the most of gbrain" coaching.

When should I use Gbrain Advisor?

Gbrain Advisor fits situations like: productivity & Automation work in your project.

How do I install Gbrain Advisor in Claude Code?

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

How do I install Gbrain Advisor in Codex?

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

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

What does Gbrain Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Gbrain Advisor is instructions for the agent only.

Does Gbrain Advisor 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 Gbrain Advisor 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 Gbrain Advisor use?

Gbrain Advisor 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 Gbrain Advisor use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Gbrain Advisor?

Skills that share tags, products or a category with Gbrain Advisor: Agent Browser (quran/quran.com-frontend-next, 1.9k stars), Perform Task (telegramdesktop/tdesktop, 33k stars), Dependency Watch (telegramdesktop/tdesktop, 33k stars) and Brave Search (badlogic/pi-skills, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gbrain Advisor?

garrytan (a GitHub user) maintains it in garrytan/gbrain, which has 30,701 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 9, 2026.

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