CtrlK
BlogDocsLog inGet started
Tessl Logo

gbrain-advisor

Proactive "make the most of gbrain" coaching. Runs `gbrain advisor` on a cadence and pings the user with the top high-leverage actions for their brain: version drift, pending migrations, stalled jobs, low embed coverage, setup smells, and uninstalled brain skills. Read-only; always asks before fixing.

69

Quality

85%

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

86%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.

A tight, operationally complete skill body: exact commands, a documented JSON contract, a severity-gated workflow with explicit user-approval checkpoints, a realistic output template, and an anti-patterns checklist. The only weaknesses are mild repetition of the ask-first invariant and the absence of error-recovery guidance for advisor failures.

Suggestions

Consolidate the read-only/ask-before-fixing rule into the Contract (or Anti-Patterns) once and reference it elsewhere, trimming 2-3 redundant restatements.

Add a brief failure-handling note after the exit-code table (e.g. non-zero/unparseable output → report the raw stderr to the user and stop) to close the error-recovery gap.

DimensionReasoningScore

Conciseness

The body is lean: it assumes Claude's competence (no explanation of what cron, JSON, or exit codes are) and every section carries operational weight — exact commands, payload schema, output template. The one redundancy is that the read-only/ask-before-fixing invariant is stated four or five times (Contract, step 5, cron prompt, Output Format, Anti-Patterns), which is deliberate emphasis but slightly over-repeated, keeping it at anchor 4 rather than 5.

4 / 5

Actionability

Fully executable throughout: `gbrain advisor --json` and `gbrain advisor --apply <dispatch_id>` are copy-paste ready, the JSON payload shape and per-finding fields (`severity`, `title`, `fix.command_argv`, `fix.dispatch_id`) are spelled out, exit codes are defined (0/1/2), and a concrete output-format example with two realistic findings is provided.

5 / 5

Workflow Clarity

The findings workflow is a clear numbered sequence (read severity-first → summarize top 1-3 → show fix.command_argv → ask → apply only with dispatch_id and explicit confirm) with real checkpoints: the exit-code severity gate, the dispatch_id presence check, and the user-approval gate. It falls short of anchor 5 because there is no error-recovery guidance for when the advisor itself fails or returns malformed/unexpected output; the read-only nature keeps it clear of the destructive/batch cap.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed — the ~100-line body is appropriately self-contained with clear section headers (Contract, When to run, How to run it, Output Format, Anti-Patterns). The two external pointers (`skills/conventions/brain-first.md` and the `cron-scheduler` skill) are clearly signaled and exactly one level deep, so navigation is trivial.

5 / 5

Total

18

/

20

Passed

Description

83%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, highly specific description that names the exact command, the delivery mechanism, and six concrete finding categories, backed by natural-language triggers in the frontmatter. The only gap is that the 'when to use' guidance is split into a separate `triggers` field rather than an explicit 'Use when...' clause inside the description text.

Suggestions

Fold a one-line 'Use when the user asks how to get more out of gbrain, wants a brain checkup, or mentions gbrain advisor' clause directly into the description text so the 'when' is explicit without relying on the separate triggers field.

Add one or two common user phrasings (e.g. 'brain health', 'is my brain configured correctly') to the triggers to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description names the exact command ('Runs `gbrain advisor` on a cadence'), the concrete action ('pings the user with the top high-leverage actions'), and enumerates six specific finding types ('version drift, pending migrations, stalled jobs, low embed coverage, setup smells, and uninstalled brain skills'), plus behavioral guarantees ('Read-only; always asks before fixing') — comprehensive concrete coverage of the skill's domain.

5 / 5

Completeness

'What' is explicit and concrete in the description itself, and 'when' is covered by 'Runs `gbrain advisor` on a cadence' plus the explicit trigger phrases in the frontmatter `triggers` block. It falls short of anchor 5 only because the 'Use when...' guidance lives in a separate frontmatter field rather than being explicit in the description text itself.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present — 'make the most of gbrain', 'advisor', 'checkup'-style coaching language — and the frontmatter's dedicated `triggers` block adds 'what should I do to get more out of gbrain', 'advise me on my brain', and 'weekly brain checkup'. Good coverage, but a few common variations (e.g. 'brain health', 'improve my brain') are missing, so it sits at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — every trigger term is gbrain-specific ('gbrain advisor', 'advise me on my brain', 'weekly brain checkup') and no generic wording like 'helps with setup' appears, so conflict with unrelated skills is minimal. Third-person voice is used throughout ('Runs', 'pings', 'asks'), so no voice penalty applies.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
garrytan/gbrain
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.