CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

testing

Skill validation framework PLUS daily test-suite health and regression intelligence. Validates skill conformance (frontmatter, manifest coverage, resolver coverage). Runs the project test suite in tiered phases (unit / evals / integration / system health), classifies failures, and produces a regression-aware report.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/testing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 strongly actionable, well-sequenced body: numbered protocols, concrete commands, failure-classification tables, and genuine feedback loops with escalation rules make both modes executable as written. The weaknesses are localized — redundant boilerplate stub sections, a duplicated Contract, version-pinned references, and command-less system-health bullets — rather than structural.

Suggestions

Remove or merge the trailing '## Contract' and '## Output Format' boilerplate stubs (which exist only 'for the conformance test') with Mode 1's existing '### Contract' and inline output formats, eliminating the duplicated content that costs tokens without adding guidance.

Add concrete commands to the system-health step (e.g., df -h / free -m / uptime, a psql or pg_isready one-liner for the database check) so every step in the daily protocol is executable.

Move version-pinned references like 'v0.25.1 extension' into a changelog or deprecated section, or drop the version numbers from headers, since time-sensitive identifiers age the body over time.

DimensionReasoningScore

Conciseness

The bulk is dense and useful — tables, commands, and decision lists with no explanations of concepts Claude already knows — but there is padding beyond 'minor': two trailing boilerplate sections ('## Contract', '## Output Format') that state they exist only 'for the conformance test', a '## Contract' that duplicates Mode 1's '### Contract', and time-sensitive version pins ('v0.25.1 extension') referenced outside any deprecated/old-patterns section, which the guidelines penalize. It fits 'mostly efficient but includes some unnecessary content that could be tightened' rather than level 4's 'minor instances'.

3 / 5

Actionability

Mostly executable, copy-paste-ready guidance: 'bun test test/skills-conformance.test.ts test/resolver.test.ts test/openclaw-plugin-manifest.test.ts', 'gbrain doctor --fast --json', 'git log --oneline --since="24 hours ago"', plus concrete classification tables, report templates, and a state JSON schema. The minor gap is the system-health step, which lists checks ('Disk / memory / CPU', 'Database connection (if applicable)', 'Critical files exist') without the actual commands, keeping it below the fully-executable anchor 5.

4 / 5

Workflow Clarity

Both modes have clearly numbered phase sequences, explicit validation checkpoints (classify each failure before acting; 'retry once' for flakes; 'never auto-fix' security failures), feedback loops for error recovery (the 'When it fails' section routes gbrain/doctor/db errors to specific remedies), and checklists (DO/DO NOT auto-fix, Anti-Patterns). The auto-fix path appropriately gates risky edits behind ask-first rules, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

Good structure: two modes cleanly separated, well-labeled sections, and clearly signaled one-level-deep references to sibling files ([conventions/quality.md](../conventions/quality.md), [agent-operator-protocol.md](../conventions/agent-operator-protocol.md)) with no nested reference chains. It falls short of anchor 5 because the ~240-line body inlines material (the regression-history JSON schema, duplicated contract text, boilerplate stub sections) that could live in a reference file, and no bundle reference files exist to offload detail.

4 / 5

Total

16

/

20

Passed

Description

63%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 specific, action-dense description that clearly states what the skill does across both of its modes, held back by a missing explicit use-when clause and the absence of the natural trigger phrases that live only in the frontmatter triggers list. The dual-domain framing ('skill validation PLUS test-suite health') is well described but slightly jargon-heavy for routing by description alone.

Suggestions

Add an explicit 'Use when...' clause to the description itself, e.g. 'Use when the user asks to run the tests, check how the tests are doing, what's broken, or to validate/conformance-check skills', so the description answers 'when' without relying on the separate triggers list.

Fold the natural user phrasings from the triggers list ('run the tests', 'how are the tests', 'what's broken', 'daily test run') into the description body to improve trigger-term coverage and routing from the description alone.

Trim the marketing-style 'PLUS' construction ('Skill validation framework PLUS daily test-suite health') into plain third-person declarative phrasing.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions with sub-detail: 'Validates skill conformance (frontmatter, manifest coverage, resolver coverage)' and 'Runs the project test suite in tiered phases (unit / evals / integration / system health), classifies failures, and produces a regression-aware report'. This matches the anchor for comprehensive coverage of specific actions; it is not the level below because coverage of both modes' actions is explicit rather than leaving gaps.

5 / 5

Completeness

The 'what' is clear and detailed (validation, tiered test runs, failure classification, regression report) but the description contains no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because the 'when' lives entirely in the frontmatter triggers list rather than in the description.

3 / 5

Trigger Term Quality

Relevant keywords are present ('test suite', 'regression', 'classifies failures', 'daily') but the phrases a user would naturally say ('run the tests', 'how are the tests', 'what's broken') exist only in the separate triggers list, not the description, and jargon like 'resolver coverage' and 'tiered phases' dominates. Some relevant keywords with common variations missing fits the 3 anchor; it falls short of 4 because the most natural user phrasings are absent from the description itself.

3 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — skill conformance validation combined with regression-classified test reporting ('manifest coverage', 'resolver coverage', 'classifies failures') is unlikely to trigger for unrelated skills, though the 'runs the project test suite' half overlaps territory shared with any generic testing skill. This fits 'mostly distinct; minor overlap risk' rather than the clear-niche anchor 5.

4 / 5

Total

15

/

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: 2 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

skills/testing/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.