# Skillpack Check

> Ejecuta `gbrain skillpack-check` para generar un reporte JSON legible por agentes sobre la salud del install de gbrain, combinando `gbrain doctor` y `apply-migrations --list`.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/skillpack-check
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/skillpack-check.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 10 días
Coste de contexto: 116 tok instalada, 1.1k tok al activarse, 1.1k tok con todos los archivos del bundle
Bundle: 1 archivo, 4 KB
Permisos que pide: shell

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add garrytan/gbrain --skill skillpack-check --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill skillpack-check --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill skillpack-check --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill skillpack-check --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill skillpack-check --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill skillpack-check --agent cline
```

## Qué hace

- Ejecuta `gbrain skillpack-check` para producir un reporte JSON de salud del install de gbrain
- Combina `gbrain doctor` y `gbrain apply-migrations --list` en un único informe
- Devuelve `healthy`, `summary`, `actions[]` y códigos de salida (0, 1, 2) para automatizar la respuesta
- Indica qué comandos de remediación ejecutar cuando `healthy` es false

## Cuándo usarla

- El usuario pregunta '¿gbrain está sano?'
- Se dispara un cron de chequeo matutino (morning-briefing)
- Algo parece fallar (jobs no corren, el brain no se actualiza, autopilot en silencio)
- En una pipeline de CI, usando el código de salida como gate

## Cuándo no

- No lo ejecutes en cada turno de chat; con una vez por hora o bajo pedido del usuario alcanza

## Qué la activa

- "¿gbrain está sano?"
- "Chequea el estado del skillpack de gbrain"
- "Corre el health check del brain"
- "Investiga por qué el autopilot está en silencio"

## Antes de instalar

- Requiere el binario `gbrain` instalado y accesible en $PATH, con ~/.gbrain/ configurado.
- Necesita en el PATH: jq
- Variables de entorno: REPORT
- reads environment config

## Archivos

- SKILL.md — 4 KB

## SKILL.md

Reproducido tal cual desde garrytan/gbrain bajo MIT. Esta sección es el documento original y está en inglés.

# 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:

```bash
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:

1. `which gbrain` returns a path
2. `gbrain --version` exits 0
3. `~/.gbrain/` is accessible

## Output format

```json
{
  "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": "..."
  }
}
```

## Anti-Patterns

- ❌ Running without `--quiet` in a cron that emails its output — you'll get
  the full JSON blob in every daily email. Use `--quiet` in crons.
- ❌ Ignoring exit code 2. A crashed doctor is worse than a failing check
  because you don't even know what's wrong.
- ❌ Running on every chat turn. Once per hour (or on user request) is plenty.
- ❌ Treating warnings as failures. Only `fail` status needs action;
  `warn` is informational.

## Output Format

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.

## Related

- `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.

## Dónde encaja

- Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes.
- Creador: [garrytan](https://skillsagentes.com/creators/garrytan.md) — 134 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Setup](https://skillsagentes.com/skills/garrytan/gbrain/setup.md): Configura GBrain con auto-aprovisionamiento de Supabase o PGLite, inyección en AGENTS.md y primera importación.
- [Maintain](https://skillsagentes.com/skills/garrytan/gbrain/maintain.md): Chequeos de salud del brain: aplicación de back-links, auditoría de citas, validación de filing, detección de info obsoleta, páginas huérfanas y benchmarks.
- [Schema Unify](https://skillsagentes.com/skills/garrytan/gbrain/schema-unify.md): Migra un brain de gbrain-base a la taxonomía de 14 tipos canónicos de gbrain-base-v2 usando gbrain onboard --check y el handler Minion unify-types.
- [Retrieval Reflex](https://skillsagentes.com/skills/garrytan/gbrain/retrieval-reflex.md): Cuándo y qué recuperar: abre la página del brain de una entidad relevante antes de responder desde memoria.
- [Minion Orchestrator](https://skillsagentes.com/skills/garrytan/gbrain/minion-orchestrator.md): Skill unificado de Minions para jobs deterministas de shell y orquestación de subagentes LLM: cola durable, observable y controlable, más la doctrina de ejecución durable para operaciones largas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)