CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verification-planning

Use before implementing a feature, bug fix, refactor, or cross-system change to plan a credible project-specific verification path.

Quality

69%

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 ./src/skills/verification-planning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

52%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 well-structured, methodologically coherent planning skill whose numbered steps and per-step completion criteria give it a clear spine. Its main weakness is that it never descends from abstraction: no worked example, template, or concrete instantiation of an evidence path or verification affordance, leaving a reader to translate philosophy into practice unaided.

Suggestions

Add a short worked example — one claim, its failure modes, the chosen evidence path, and a small resulting verification affordance — so the abstract directives have a concrete instantiation (actionability).

Fold 'Set a verification budget' into the numbered sequence or renumber the steps so the 1-6 flow is not interrupted by an unnumbered section (workflow_clarity).

Tighten ornate passages such as 'The purpose is not to select a familiar technique...' and the two-paragraph affordance introduction to reduce token cost (conciseness).

DimensionReasoningScore

Conciseness

The body is mostly disciplined — every section carries guidance and there is no primer on concepts Claude already knows — but passages like "The purpose is not to select a familiar technique. The purpose is to decide how this system can reveal the truth of this particular change" and the two-paragraph introduction of the affordance concept are ornate and could be tightened. This is more than minor trimmable over-explanation (a 4) but well short of padded verbosity (a 2).

3 / 5

Actionability

The guidance is procedural ("State the behavior that needs to become true", "Derive possible evidence paths from the system itself") but operates entirely at a methodological altitude with no worked example, template, command, or concrete instantiation of an evidence path or affordance in a real project. It instructs rather than merely describes (above a 1), but the specific steps a reader would execute against an actual system are missing, matching the 'high-level hints' anchor.

2 / 5

Workflow Clarity

The six numbered steps are clearly sequenced and each carries an explicit "**Complete when:**" checkpoint — genuine validation gates, so this is above anchor 3 (checkpoints missing or implicit). It falls short of a 5 because there are no error-recovery/feedback loops (no 'if the evidence refutes the claim, do X') and the unnumbered "Set a verification budget" section is inserted between steps 2 and 3, disrupting the numbered flow.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~107-line single-file body is well organized with clear section headers and consistent 'Complete when' closure criteria — good structure with content appropriately placed. The under-50-line exception for a 5 does not apply, and some detailed guidance (affordance design criteria, the budget rules) is dense enough that it could live in reference files if the skill grew, keeping this at anchor 4 rather than 5.

4 / 5

Total

13

/

20

Passed

Description

70%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 solid description that explicitly answers both what the skill does and when to use it, with natural trigger terms covering the main change types. Its limits are a single abstract capability statement rather than enumerated concrete actions, and missing everyday verification synonyms like 'test' or 'validate'.

Suggestions

Enumerate the concrete planning capabilities (frame the claim, design an evidence path, build a verification affordance) instead of the single abstract phrase 'plan a credible project-specific verification path' (specificity).

Add natural trigger synonyms such as 'test', 'verify', or 'validate the change' so the skill surfaces when users phrase verification needs in everyday language (trigger_term_quality).

DimensionReasoningScore

Specificity

The description names its domain (verification planning) and exactly one concrete action — "plan a credible project-specific verification path" — which matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is a genuinely specific action rather than generic handling (above a 2), but it does not list several distinct actions like the 4-5 anchors do.

3 / 5

Completeness

Both halves are explicit: the 'what' is "plan a credible project-specific verification path" and the 'when' is "Use before implementing a feature, bug fix, refactor, or cross-system change" with concrete trigger contexts. It sits just below a 5 because the 'what' is a single, somewhat abstract action — 'credible', 'project-specific', 'path' are qualifiers rather than enumerated capabilities — leaving the what-side less concrete than the when-side.

4 / 5

Trigger Term Quality

"feature, bug fix, refactor, or cross-system change" plus "implementing" gives good coverage of natural user phrasings for change work. It falls short of a 5 because common verification synonyms users actually say — 'test', 'testing', 'verify', 'validate the change' — are absent, but the missing terms are few rather than systematic, matching anchor 4.

4 / 5

Distinctiveness Conflict Risk

Planning a verification path before implementation is a recognizable niche distinct from execution skills (testing libraries, code review, security review), and the trigger is scoped to pre-implementation planning. Minor overlap remains: 'before implementing a feature, bug fix, refactor' is broad enough to brush against general planning and test-planning skills, fitting 'mostly distinct; minor overlap risk' rather than the minimal-conflict 5.

4 / 5

Total

15

/

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

alvinunreal/oh-my-opencode-slim

Path

src/skills/verification-planning/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.