CtrlK
BlogDocsLog inGet started
Tessl Logo

gbrain-upgrade

Keep gbrain current. When a `gbrain` invocation prints an `UPGRADE_AVAILABLE <old> <new>` marker (or `gbrain self-upgrade --check-only` reports an update), apply it per the configured self_upgrade.mode: notify (prompt the operator with a 4-option question + snooze) or auto (apply silently). The action is always the hardcoded `gbrain self-upgrade` — never a command read from the marker.

79

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The content is a tight, fully-actionable runbook: executable commands, a concrete operator prompt, explicit validation checkpoints for a mutating operation, and a well-organized section structure. It rewards Claude's competence without redundancy and bakes safety (never run marker-embedded commands) directly into the contract and anti-patterns.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — a brief blockquote plus tight mode branches with executable commands, no padding explaining what gbrain or self-upgrade is, and every line carries operational weight.

3 / 3

Actionability

It gives fully executable commands (gbrain config get/set, gbrain self-upgrade, --check-only --json), an exact 4-option prompt template, and literal output-format strings — copy-paste ready with no pseudocode.

3 / 3

Workflow Clarity

The flow is clearly sequenced by mode (off/auto/notify) with explicit validation checkpoints — a --check-only --json confirmation, a version regex gate before display, and failed_versions skipping — plus feedback loops via snooze escalation and doctor hints.

3 / 3

Progressive Disclosure

With no bundle files present, the self-contained body is well-organized into clearly signaled sections (Contract, When to run, Inline upgrade flow, Anti-Patterns, Output Format) with no nested references, fitting a single-purpose skill.

3 / 3

Total

12

/

12

Passed

Description

100%

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

The description is specific, action-oriented, and in third person, clearly stating both what the skill does and when to use it with rich natural triggers. It also usefully bakes in the security constraint that the action is always the hardcoded command, never one parsed from the marker.

DimensionReasoningScore

Specificity

The description names multiple concrete actions — reads the UPGRADE_AVAILABLE marker, applies per self_upgrade.mode, prompts the operator with a 4-option question + snooze in notify mode, and applies silently in auto mode.

3 / 3

Completeness

It answers both 'what' (apply the upgrade per the configured mode) and 'when' (when a gbrain invocation prints the UPGRADE_AVAILABLE marker or --check-only reports an update), with explicit trigger guidance rather than mere implication.

3 / 3

Trigger Term Quality

It surfaces natural phrasings an operator would actually say ('upgrade gbrain', 'update gbrain', 'keep gbrain current', 'gbrain is out of date') alongside the technical UPGRADE_AVAILABLE marker, giving strong keyword coverage.

3 / 3

Distinctiveness Conflict Risk

It targets a narrow, product-specific niche (gbrain self-upgrade handling) with dedicated triggers, making it very unlikely to fire for an unrelated skill.

3 / 3

Total

12

/

12

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.

Validation15 / 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.