skillpack-check

Generates a JSON health report for gbrain installs by composing doctor and migration checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Operators of a gbrain install lack a single agent-readable signal for whether the skillpack is healthy, forcing them to manually run doctor checks and migration listings and interpret the results themselves. ## Core Features & Use Cases - Unified health report: Wraps gbrain doctor and gbrain apply-migrations --list into one JSON payload with healthy, summary, actions, doctor, and migrations fields. - Exit-code gating: Returns 0 when healthy, 1 when remediation is needed, and 2 when the state cannot be determined, so crons and CI pipelines can gate on the code alone. - Actionable remediation: The actions[] array lists the exact commands to run (e.g. gbrain apply-migrations --yes, gbrain embed --stale, gbrain check-backlinks fix). - Use Case: Wire gbrain skillpack-check --quiet into a morning-briefing cron so the agent surfaces a one-line alert only when the brain needs attention. ## Quick Start Ask your agent to run gbrain skillpack-check and report whether the install is healthy along with any remediation commands.

Frequently Asked Questions about skillpack-check

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

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

Run `gbrain skillpack-check` to get a JSON report combining doctor filesystem checks and migration status. The `healthy` boolean and exit code tell you at a glance whether any action is needed.

How do I run a gbrain health check in a cron job?

Use `gbrain skillpack-check --quiet` in your cron so only the exit code matters. Exit 0 means healthy, exit 1 means run the commands in the `actions[]` array, and exit 2 means the binary or a subcommand failed.

What does exit code 2 from skillpack-check mean?

Exit code 2 means the health state could not be determined, usually because the gbrain binary is missing from PATH or a subcommand crashed. Verify `which gbrain`, `gbrain --version`, and that `~/.gbrain/` is accessible.

How do I fix a partial gbrain migration reported by skillpack-check?

Run `gbrain apply-migrations --yes`, which is idempotent. If it exits with status partial, the host has non-builtin cron handlers needing plugin registration, so follow the instructions in `skills/migrations/v0.11.0.md`.

Should warnings in the doctor output be treated as failures?

No. Only checks with `fail` status require action; `warn` entries are informational. Treating warnings as failures leads to unnecessary remediation runs.