Run `gbrain skillpack-check` to produce an agent-readable JSON health report for the gbrain install. Wraps `gbrain doctor` + `gbrain apply-migrations --list` so a host agent (Wintermute's morning-briefing, any OpenClaw cron) can see at a glance whether the skillpack needs attention. Use when the user asks "is gbrain healthy?", when a cron fires a morning check, or proactively when something seems off (jobs not running, brain not updating, autopilot silent).
Running gbrain skillpack-check returns a JSON report with:
healthy (bool): true if no action needed.summary (string): one-line summary safe to quote in a briefing.actions (string[]): every remediation command. If non-empty, run them.doctor: full gbrain doctor --fast --json output (filesystem checks).migrations: applied/pending/partial counts from apply-migrations --list.Exit code:
0 — healthy, nothing to do.1 — action needed. Read actions[] and execute.2 — could not determine (binary crash or missing subcommand). Investigate.morning-briefinggbrain skillpack-check --quietgbrain skillpack-check for the full JSON when debugging.healthy: true)Surface the summary in the agent's output only if asked. Nothing else.
healthy: false)The actions[] array contains the commands to run, in order. Execute them:
for cmd in $(echo "$REPORT" | jq -r '.actions[]'); do
eval "$cmd"
done
Common actions[] entries and what they mean:
gbrain apply-migrations --yes — A migration is pending or half-finished.
Run this (it's idempotent). If it exits status: "partial", the host has
non-builtin cron handlers that need plugin registration — follow
skills/migrations/v0.11.0.md.gbrain embed --stale — Embeddings are stale.gbrain check-backlinks --fix — Dead links or missing back-links.Run: prefix in the source message) — agent judgment
needed. Quote it in the report for the user.exit 2)Treat as urgent. Probably means the gbrain binary is missing from $PATH or
a required subcommand crashed. Check:
which gbrain returns a pathgbrain --version exits 0~/.gbrain/ is accessible{
"version": "0.11.1",
"ts": "2026-04-18T12:34:56.789Z",
"healthy": false,
"summary": "gbrain skillpack needs attention: 1 action(s) — gbrain apply-migrations --yes",
"actions": ["gbrain apply-migrations --yes"],
"doctor": {
"exit_code": 1,
"checks": [
{ "name": "minions_migration", "status": "fail", "message": "MINIONS HALF-INSTALLED (partial migration: 0.11.0). Run: gbrain apply-migrations --yes" }
]
},
"migrations": {
"applied_count": 0,
"pending_count": 0,
"partial_count": 1,
"stdout": "..."
}
}
--quiet in a cron that emails its output — you'll get
the full JSON blob in every daily email. Use --quiet in crons.fail status needs action;
warn is informational.The skill itself doesn't write files; it reports the CLI output verbatim to the user (or to the agent's briefing pipeline). One-line summary first, then the action list, then (only if relevant) the full JSON for debugging.
gbrain doctor — the underlying filesystem + DB check. skillpack-check
composes this.gbrain apply-migrations --list — the migration status view.skills/migrations/v0.11.0.md — the host-agent instruction manual for
resolving pending-host-work.jsonl items.docs/guides/minions-fix.md — troubleshooting a half-migrated install.