CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verify

Verify that a change really works before you claim completion

Quality

68%

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/verify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 tight, well-organized instruction skill: the verification ladder and honest-reporting rules are clear, and nothing pads the token budget beyond a small overlap between the Workflow and Verification order sections. Its main weakness is actionability — it tells Claude to prefer tests and run narrow checks without a single concrete example of how to do either.

Suggestions

Add one or two concrete examples of verification commands (e.g., how to discover and run the project's test suite: `npm test`, `pytest -k <name>`, or the repo's CI entrypoint) so "prefer existing tests" is executable rather than abstract.

Show what a "narrow direct command check" and its captured evidence look like in practice (command + expected output excerpt), since this is the skill's core move.

Merge the Workflow's steps 2-4 with the "Verification order" section — they restate the same ladder twice; one canonical ordered list would remove the duplication.

DimensionReasoningScore

Conciseness

The body is lean — short sections, no explanation of concepts Claude already knows, every rule earns its place. The one inefficiency is mild duplication: the Workflow steps 2-4 and the "Verification order" section restate the same tests → typecheck/build → direct commands → manual ladder. That is trimmable but minor, fitting the "efficient; minor instances that could be trimmed" anchor rather than the noticeably-verbose anchor 2 or the imperfect anchor 3.

4 / 5

Actionability

For an instruction-only skill, guidance is partially concrete: the verification ladder ("Existing tests / Typecheck / build / Narrow direct command checks / Manual or interactive validation") and the explicit Output checklist are actionable. But key details are missing — no examples of how to find and run existing tests, what a "narrow direct verification command" looks like, or what concrete observable evidence to capture. This matches "some concrete guidance but incomplete; missing key details" rather than the mostly-executable anchor 4.

3 / 5

Workflow Clarity

The process is clearly sequenced with an explicit escalation path (tests first, then typecheck/build, then narrow commands, then manual validation) and decision points ("If coverage is missing", "If direct automation is not enough", "If a check fails, include the failure clearly"). It falls short of anchor 5 because there is no explicit validate → fix → retry loop; a failed check is only reported, with no guidance on iterating toward green. Not a destructive/batch skill, so no cap applies.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and none exist (references/, scripts/, assets/ are absent). Per the simple-skill scoring note, well-organized sections alone qualify for 5: the body is cleanly split into Goal, Workflow, Verification order, Rules, and Output with no inline content that belongs in a separate file.

5 / 5

Total

16

/

20

Passed

Description

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

The description is concise and names a single clear, concrete purpose, but it reads as a tagline rather than a full trigger description. It lacks an explicit "Use when..." clause and the natural trigger vocabulary (test, check, confirm) that would let a user's phrasing reliably surface this skill.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to verify, test, or confirm that a change works, or before claiming a task is complete."

Include natural synonyms and phrasings users would say — "test this", "check that it works", "prove it", "make sure it's done" — to broaden trigger-term coverage.

Enumerate the concrete verification actions the skill performs (run existing tests, typecheck/build, narrow direct commands, manual validation) so the 'what' is comprehensive, not a single verb.

DimensionReasoningScore

Specificity

The description names the domain (change verification) and one concrete action — "Verify that a change really works" — plus context ("before you claim completion"), but stops at a single action. Anchor 4 requires several specific actions, and anchor 2's minimal-generic-action example is less informative than this, so 3 is the best fit.

3 / 5

Completeness

The "what" is clear (verify that a change actually works), but the "when" is only weakly implied by "before you claim completion" and there is no explicit "Use when..." clause, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant natural keywords are present ("verify", "change", "works", "completion"), but common variations users would say — "test this", "check that it works", "confirm", "prove" — are missing. There is no "Use when..." style trigger phrasing either, matching the anchor for some relevant keywords with missing variations.

3 / 5

Distinctiveness Conflict Risk

"Verify that a change really works before you claim completion" carves out a recognizable niche (evidence before completion claims), but it would plausibly fire alongside testing, CI, debugging, and code-review skills. It overlaps with similar skills rather than being clearly distinct (anchor 4) or entirely generic (anchor 2).

3 / 5

Total

12

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Yeachan-Heo/oh-my-claudecode

Path

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