CtrlK
BlogDocsLog inGet started
Tessl Logo

review-tests

Use when checking whether a branch is adequately tested — building and running the affected workspaces, then auditing changed code for missing test files, untested exports, untested error paths and untested routes — and reporting gaps with T-M/U/E/R/S IDs in the four-field format.

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

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 highly actionable, well-sequenced workflow skill: every step has executable commands, explicit validation, and error-recovery paths, and the report format is enforced with concrete grep checks. Its main weakness is verbosity — the shape-check rules are repeated several times — and its length sits entirely in one file rather than being split across a reference bundle.

Suggestions

State the five-heading shape check and the banned-heading list once (e.g. in the 'Report shape' section) and reference it from Steps 0 and 4 instead of repeating the full rule three times — this would cut roughly 20 lines without losing the constraint.

Trim the rhetorical framing (e.g. 'a run that leaves a differently-shaped file has produced nothing, however good the audit inside it', 'and that is the one way this run fails outright') down to their single operative instruction, since the commands and checks already enforce the behavior.

Move the 'Finding format' and 'Report shape' sections into a references/ file (e.g. REPORT-FORMAT.md) and keep a short inline template plus a clearly signaled link, so the step-by-step workflow in SKILL.md stays lean.

DimensionReasoningScore

Conciseness

The body is mostly efficient instruction with no explanation of concepts Claude already knows, but it repeats itself: the five-heading shape check appears three times (Step 0, mid-Step 4, and the final check section), the banned-heading list ("## Summary", "## Verdict", "## Scope and method", "## Bottom line") is stated twice nearly verbatim, and passages like "a run that leaves a differently-shaped file has produced nothing, however good the audit inside it" are rhetorical padding. It is above level 2 because every section still carries real, non-generic instruction rather than padded explanation.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: the `cat > TEST-REVIEW.md <<'EOF'` skeleton, `bun run --cwd <workspace-path> build` / `test:run` commands, the `ls`/`find` test-layout resolution, exact `grep -c` validation commands, and an exact four-field finding template. It matches the level-5 anchor — concrete commands and examples cover the common cases, exceeding level 4's 'minor gaps'.

5 / 5

Workflow Clarity

Steps 0–4 are explicitly sequenced with built-in validation checkpoints (`grep -c '^## ...'` must print 5, checked as soon as the first gap is written and again before finishing) and feedback loops (restore the five headings and re-edit; "No step is a stop" — a failing build or test is recorded under `## Not run` and the run continues). This matches the level-5 anchor with both explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

The single SKILL.md is well-sectioned with clear headers, and its two external pointers (`wiki/conventions/testing-patterns.md`, `wiki/conventions/browser-tests.md`) are one level deep and clearly signaled in context. It is not level 5 because at ~207 lines it is a monolithic file with no bundle — the finding-format and report-shape detail could live in a reference file; it is above level 3 because structure and signaling are good and nothing is buried.

4 / 5

Total

17

/

20

Passed

Description

88%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 states concrete capabilities comprehensively and opens with an explicit, natural 'Use when' trigger. Its only weaknesses are a few missing natural synonyms (e.g. 'test coverage') and minor overlap with general code-review trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions spanning the full pipeline — "building and running the affected workspaces", "auditing changed code for missing test files, untested exports, untested error paths and untested routes", and "reporting gaps with T-M/U/E/R/S IDs" — with comprehensive coverage of the skill's domain. It exceeds the level-4 anchor because there are no minor gaps in action coverage, not even extensions or peripheral tasks left unnamed.

5 / 5

Completeness

It explicitly answers both halves: "Use when checking whether a branch is adequately tested" gives a concrete when-clause, and the rest of the sentence fully states what the skill does (build, run, audit four gap types, report with IDs). It matches the level-5 anchor exactly and is above level 4, where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

Natural trigger phrases like "checking whether a branch is adequately tested", "test files", "untested exports", "error paths" and "routes" match what a user would actually say. It falls short of the level-5 anchor because common synonyms and variations such as "test coverage", "run the tests", or "CI" are absent.

4 / 5

Distinctiveness Conflict Risk

Terms like "branch", "adequately tested" and the T-M/U/E/R/S ID scheme carve a distinct niche. It is not level 5 because the skill shares the "review/check this branch" trigger space with general code-review and PR-review skills, creating minor overlap risk with closely related skills.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
englishstventures/osn
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.