CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skillpack-check

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 (your OpenClaw'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).

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplar of actionable, report-only skill writing: fully specified commands, explicit exit-code branching with an error-recovery triage loop, and a concrete output contract. The only notable flaws are structural — a duplicated "Output Format" heading and a safety caveat repeated four times — which cost it at the top of the conciseness and organization range.

Suggestions

Merge the two "Output Format" sections (lines 91 and 134) under one heading; the duplicate name splits format-spec from report-ordering guidance that belongs together.

State the approval caveat once (e.g. in "Action needed") and cross-reference it from the other three places, trimming the repeated "requires separate, explicit approval / confirm scope and budget" lines.

Show how $REPORT is obtained (e.g. `REPORT=$(gbrain skillpack-check)` or piping output directly) so the jq snippet is copy-paste ready with no setup inferred.

DimensionReasoningScore

Conciseness

The body is dense with skill-specific operational content (exit-code contract, per-path handling, action meanings, anti-patterns) and explains nothing Claude already knows, fitting the efficient anchor. Minor trimming opportunities keep it below 5: the report-only caveat is repeated four times ("requires separate, explicit approval", "do not execute", "confirm scope and budget", "A health check... does not authorize repairs"), and there are two same-named "Output Format" sections (lines 91 and 134) covering overlapping ground.

4 / 5

Actionability

Every instruction is a concrete, executable command: `gbrain skillpack-check --quiet` for crons, `printf '%s\n' "$REPORT" | jq -r '.actions[]'`, the exit-2 triage steps (`which gbrain`, `gbrain --version`, `~/.gbrain/`), plus a full sample JSON output. Specific examples cover the common cases (healthy, action-needed with four enumerated action types, undetermined failure), matching the anchor-5 description; the only imperfection — `$REPORT` is never shown being captured — is trivial for an agent.

5 / 5

Workflow Clarity

The workflow is unambiguous for a single-purpose skill: run the check, branch on exit code 0/1/2, and each branch has explicit handling — including a numbered diagnostic feedback loop for exit 2 (binary present → version exits 0 → dir accessible). The exit code itself is the validation gate for cron/CI use, and the skill is explicitly non-mutating (`mutating: false`), so the destructive-operation validation cap does not apply.

5 / 5

Progressive Disclosure

The body is well organized into clear sections (Contract, When to run, What to do with the output, When it fails, Anti-Patterns, Related) with one-level-deep, clearly annotated references (`../conventions/agent-operator-protocol.md`, `skills/migrations/v0.11.0.md`, `docs/guides/minions-fix.md`); no bundle files exist to nest. It stops short of a 5 because of a minor organization gap: two sibling sections share the identical heading "Output Format" (one showing the JSON schema, one describing report ordering), which muddies navigation.

4 / 5

Total

18

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit what + when structure, concrete trigger phrases (including a quoted user question and symptom synonyms), and a clearly distinct niche. Its main deduction is mechanical: the second-person parenthetical "(your OpenClaw's morning-briefing...)" violates the third-person voice rule and costs a specificity point.

Suggestions

Rewrite the parenthetical in third person, e.g. "(a host agent's morning-briefing, any OpenClaw cron)", to remove the second-person usage that triggers the specificity penalty.

Fold one or two natural variations from the frontmatter triggers (e.g. "gbrain health", "check the brain") into the 'Use when' clause so the description itself carries broader natural-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Run `gbrain skillpack-check` to produce an agent-readable JSON health report", "Wraps `gbrain doctor` + `gbrain apply-migrations --list`" — which matches the score-4 anchor (several specific actions, minor gaps: it doesn't hint at what the report contains or the exit-code contract). However, the judging guideline penalizes second-person voice by 1, and the parenthetical "(your OpenClaw's morning-briefing, any OpenClaw cron)" addresses the reader in second person, dropping the score to 3.

3 / 5

Completeness

Both halves are explicit: the what ("Run `gbrain skillpack-check` to produce an agent-readable JSON health report... Wraps `gbrain doctor` + `gbrain apply-migrations --list`") and the when ("Use when the user asks 'is gbrain healthy?', when a cron fires a morning check, or proactively when something seems off"), with concrete trigger phrases. This squarely matches the anchor-5 example structure of what + Use-when with concrete triggers.

5 / 5

Trigger Term Quality

The description embeds natural phrases users would actually say: the quoted question "is gbrain healthy?", plus symptom phrases "jobs not running, brain not updating, autopilot silent" and "a cron fires a morning check". This is good keyword coverage (anchor 4); a few natural variations (e.g. "gbrain health", "check the brain") appear only in the frontmatter `triggers` list, not in the description text itself, so coverage is not comprehensive within the evaluated field.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous: a health check for the gbrain install consumed by a host agent ("morning-briefing", "OpenClaw cron"). The trigger phrase "is gbrain healthy?" is distinct to this skill, and nothing in the description overlaps with generic document/file/code skills — minimal conflict risk per the anchor-5 description.

5 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

skills/skillpack-check/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.