skillpack-check

Skillpack Check

Contract

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.

When to run

• Daily cron (e.g. your OpenClaw's morning-briefing): gbrain skillpack-check --quiet. Exit code alone tells you if anything is wrong; surface a one-liner in the briefing only when exit != 0. No JSON noise in happy-path briefings.
• On demand: gbrain skillpack-check for the full JSON when debugging.
• In a CI pipeline: same pattern — exit code gates, JSON is the evidence.

What to do with the output

Happy path (healthy: true)

Surface the summary in the agent's output only if asked. Nothing else.

Action needed (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.
• Free-text action (no Run: prefix in the source message) — agent judgment needed. Quote it in the report for the user.

Determine failure (exit 2)

Treat as urgent. Probably means the gbrain binary is missing from $PATH or a required subcommand crashed. Check: