CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

87%

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

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

An exceptionally actionable, well-sequenced workflow with explicit validation and recovery steps tailored to this repository. Its weaknesses are redundancy — the report-shape rules are restated three times — and a monolithic single-file layout that inlines content (mutation testing, tautology checklist) that belongs in reference files.

Suggestions

State the report-shape rules once (in Step 0 or "Report shape") and cross-reference them elsewhere; the "never add a sixth `##`" / "summary sentence goes at the top of `## Coverage gaps`" guidance and the `grep -c` check are each repeated nearly verbatim.

Move the Step 5 mutation-testing details (Stryker invocation, STRYKER_TESTS, log interpretation) and the tautology-shape checklist into a references/ file, keeping a one-line rule plus pointer in SKILL.md to shorten the always-loaded body.

DimensionReasoningScore

Conciseness

The body is repo-specific with no padding about concepts Claude already knows, but the report-shape rules are repeated nearly verbatim three times — "Never add a sixth `##`: `## Summary`, `## Verdict`…" and "A summary sentence goes at the top of `## Coverage gaps`" appear in both Step 0 and the final section, and the `grep -c` shape check is given twice. This is more than the minor over-explanation of the 4 anchor, but the content is operational rather than padded, keeping it above 2.

3 / 5

Actionability

Guidance is copy-paste ready throughout: the heredoc report skeleton, `bun run --cwd <workspace-path> test:run`, `STRYKER_TESTS='tests/lib/money.test.ts' bun run --cwd cire/api test:mutation --base "$DIFF_BASE"`, the `grep -c '^## \(Build\|…\)$' TEST-REVIEW.md` validation, and a fill-in four-field finding template. Placeholders like `<workspace-path>` are inherent parameterization, not gaps, so the 4 anchor does not fit better.

5 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced with explicit validation checkpoints ("It must print `5`") and error-recovery feedback loops ("restore the five headings, put the gap back under `## Coverage gaps`"). The "No step is a stop" failure policy and "record each gap the moment you have it" make the checkpoints explicit, matching the 5 anchor rather than the 4.

5 / 5

Progressive Disclosure

There are no bundle files; everything lives inline in one ~280-line SKILL.md, and substantial content that belongs in reference files — the Step 5 mutation-testing details and the tautology-shape checklist — is inlined. Structure and navigation are good (clear `##` steps, signaled `wiki/conventions/` pointers), which lifts it above the 2 anchor, but the inline bulk fits the 3 anchor better than the 4.

3 / 5

Total

16

/

20

Passed

Description

92%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 a specific, multi-action pipeline, an explicit "Use when" trigger, and a distinctive output format, all in third person without padding. The only weakness is missing a few natural synonyms (e.g., "test coverage", "coverage gaps") that users might say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "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 in the four-field format" — giving comprehensive coverage of what the skill does. It exceeds the score-4 anchor (minor gaps) because the action list spans the full pipeline from build to report.

5 / 5

Completeness

It explicitly answers both questions: the what is the concrete build/test/audit/report action list, and the when is the opening "Use when checking whether a branch is adequately tested" with concrete trigger phrasing. The 4 anchor would require the when to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Phrases like "checking whether a branch is adequately tested", "untested exports" and "untested error paths" are terms a user would naturally say, giving good keyword coverage. It falls short of the 5 anchor because common variations such as "test coverage", "coverage gaps" or "unit/integration tests" are absent.

4 / 5

Distinctiveness Conflict Risk

The niche — auditing a branch's test coverage with a T-M/U/E/R/S finding taxonomy in a four-field report — is distinct, and the trigger (branch test adequacy) is unlikely to fire a neighboring skill. No minor overlap risk keeps it below the 5 anchor.

5 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

englishstreetventures/osn

Path

.claude/skills/review-tests/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.