CtrlK
BlogDocsLog inGet started
Tessl Logo

smoke-test

Health smoke tests + auto-fix for gbrain installs (and OpenClaw services when present). Run after machine/container restarts or whenever something seems broken. Tests critical services, auto-fixes bounded local issues, and reports worker topology without starting daemons. Extensible via user-defined test scripts in ~/.gbrain/smoke-tests.d/*.sh.

68

Quality

84%

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

81%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 high-quality, self-contained skill body: executable commands, tables, explicit validate-then-fix-then-retest workflows, and well-organized sections. Remaining polish is structural — moving contributor and known-issue detail into reference files would improve both conciseness and progressive disclosure.

Suggestions

Move the 'Adding Built-in Tests' contributor pattern and 'Known Issues & Their Auto-Fixes' detail into a reference file (e.g. references/contributing.md) and keep a one-line pointer in SKILL.md.

Replace the placeholder template ('[test condition]', '[fix command]') with one complete, executable example test block.

Trim the 'Known Issues' prose to symptom → cause → fix bullets to cut a few tokens.

DimensionReasoningScore

Conciseness

Mostly lean — dense tables ('Built-in Tests', 'Environment Variables'), terse bullets, and no explanation of concepts Claude already knows. Minor over-explanation in the 'Known Issues & Their Auto-Fixes' narrative and the contributor-oriented sections inlined in a runtime doc. Anchor 4 (efficient, minor trimming possible), not 5 (not every token earns its place) and not 3 (padding is minor, not a real efficiency problem).

4 / 5

Actionability

Concrete executable commands throughout: 'gbrain smoke-test', a copy-paste-ready drop-in example ('redis-cli ping | grep -q PONG'), an env var table with defaults, and explicit output/exit-code semantics. The contributor 'pattern' block is placeholder pseudocode ('[test condition]', '[fix command]') — explicitly framed as a template but still keeping it short of fully copy-paste ready. Anchor 4, not 5.

4 / 5

Workflow Clarity

Validation feedback loops are explicit and central: design rules 'Test first — never fix without confirming broken' and 'Re-test after fix', the documented 'pass → fail-detected → fix → re-test' contract, skip-vs-fail semantics, exit-code meaning, and anti-patterns reinforcing each rule. This mutating skill has fully explicit checkpoints and error-recovery loops, matching anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist; the single SKILL.md is well-sectioned and easy to navigate. However, at ~160 lines it exceeds the under-50-line simple-skill exception, and contributor material ('Adding Built-in Tests', 'Known Issues') is inlined where separate reference files could keep the runtime doc leaner. Anchor 4 (good structure, minor organization gaps), not 5.

4 / 5

Total

17

/

20

Passed

Description

87%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: it names concrete capabilities, an explicit trigger condition, and a well-scoped niche with low conflict risk. Its only weakness is slightly incomplete action coverage — the services being tested are summarized rather than enumerated.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Tests critical services, auto-fixes bounded local issues, and reports worker topology' plus 'Extensible via user-defined test scripts' — but doesn't enumerate the specific services, leaving minor coverage gaps. Fits anchor 4 (several specific actions, minor gaps), not 5 (not comprehensive) and not 3 (more than 1-2 concrete actions).

4 / 5

Completeness

Explicitly answers both what ('Tests critical services, auto-fixes bounded local issues, and reports worker topology without starting daemons') and when ('Run after machine/container restarts or whenever something seems broken'). Matches anchor 5 exactly; not 4 since the when-clause is fully explicit and concrete.

5 / 5

Trigger Term Quality

Natural phrases users would actually say — 'smoke tests', 'Run after machine/container restarts', 'whenever something seems broken' — complemented by the triggers list ('health check', 'did the restart break anything'). A few natural synonyms (e.g. 'diagnose services', 'verify install') are missing, so anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to a clear niche — 'gbrain installs (and OpenClaw services when present)' — with distinct triggers (smoke test, restart check) that no generic skill would claim. Clear niche with minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

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.