gbrain-advisor

Runs gbrain advisor checks and reports ranked brain-maintenance findings with fix commands.

29.4k|4.4k|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/garrytan/gbrain --skill gbrain-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gbrain-advisor
Source: https://github.com/garrytan/gbrain/tree/main/plugin/skills/gbrain-advisor
Command: npx skills add https://github.com/garrytan/gbrain --skill gbrain-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A knowledge brain drifts out of health silently: pending schema migrations, version lag, stalled jobs, low embedding coverage, and missing backups go unnoticed until something breaks. This Skill runs the read-only gbrain advisor diagnostic on demand or on a weekly cadence and surfaces the highest-leverage maintenance actions before they become problems.

Core Features & Use Cases

  • Ranked health findings: Executes gbrain advisor --json and interprets severity-gated results (critical, warn, info) covering migrations, version drift, stalled jobs, embed coverage, and backup status.
  • Consent-gated fixes: Shows the exact fix.command_argv for each finding and only runs gbrain advisor --apply <dispatch_id> after explicit user approval.
  • Scheduled checkups: Provides a weekly cron recipe that reports only what is new since the last run, avoiding repeated nagging over ignored low-severity items.
  • Use Case: Every Monday morning, the agent pings you with "2 things worth your attention" — a critical pending migration and an available gbrain upgrade — each with the exact fix command, waiting for your yes.

Quick Start

Ask the agent to run a gbrain advisor checkup and summarize the top findings with their fix commands.

Frequently Asked Questions about gbrain-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my gbrain setup is healthy?

Run gbrain advisor --json to get a ranked list of findings with severity levels. Exit code 0 means clean, 1 means warnings, and 2 means a critical issue such as pending schema migrations.

How do I schedule a weekly gbrain health check?

Install a weekly cron job whose prompt reads this skill and runs gbrain advisor --json. The advisor keeps local run history, so each run reports only findings that are new since the last check.

Can the gbrain advisor fix problems automatically?

The advisor itself is read-only and never mutates state. Findings with a dispatch_id can be applied via gbrain advisor --apply, but only after the user explicitly approves the fix.

What kinds of issues does gbrain advisor detect?

It detects pending schema migrations, gbrain version drift, stalled jobs, low embedding coverage, setup misconfigurations, uninstalled brain skills, and knowledge repos lacking a git remote for backups.

Why does the advisor return different results over MCP than locally?

Over MCP the advisor returns brain-state signals only. Findings about uninstalled skills and workspace install state are local-CLI concerns and do not appear in MCP responses.