gbrain-advisor

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

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill gbrain-advisor-amc-jtc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gbrain-advisor
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/plugin/skills/gbrain-advisor
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill gbrain-advisor-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge-brain deployments drift over time: versions go stale, schema migrations pile up, jobs stall, and embedding coverage drops. This Skill surfaces those issues proactively as a ranked, severity-tagged list so the owner knows exactly what to fix and how, without digging through logs. ## Core Features & Use Cases - Ranked health findings: Runs gbrain advisor --json and returns findings with severity (critical/warn/info), a one-line explanation, and the exact fix command for each issue. - Read-only by contract: Never mutates brain state; every fix is shown to the user and executed only after explicit approval, optionally via gbrain advisor --apply <dispatch_id>. - Weekly cadence checkup: Includes a cron recipe for a weekly brain checkup that reports only what is new since the last run, avoiding repeated nagging. - Use Case: On Monday morning, the scheduled job detects pending schema migrations and an available gbrain upgrade, then pings the user with the two findings and their exact fix commands, asking before running anything. ## Quick Start Ask the assistant 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 the health of my gbrain knowledge base?

Run `gbrain advisor --json` to get a ranked list of findings covering version drift, pending migrations, stalled jobs, and embedding coverage. Each finding includes a severity level and the exact fix command to resolve it.

How do I schedule a weekly gbrain advisor checkup?

Install a weekly cron job whose prompt reads the gbrain-advisor SKILL.md and runs `gbrain advisor --json`. The advisor is read-only and idempotent, so a double-fire is harmless, and it reports only what is new since the last run.

Does gbrain advisor modify my brain data automatically?

No, the advisor is read-only by contract and never mutates brain state. It prints findings and fix commands, and any fix runs only after explicit user approval, optionally via `gbrain advisor --apply <dispatch_id>`.

What do the gbrain advisor exit codes mean?

The exit code acts as a severity gate: 0 means clean, 1 means warnings exist, and 2 means a critical finding such as pending schema migrations. The JSON payload includes the worst severity and the full findings list.

Why does the advisor over MCP not show uninstalled skills?

Over MCP the advisor returns brain-state signals only, so workspace install state is not visible. Uninstalled-skill findings are a local-CLI concern and require running the advisor through the local command line.