CtrlK
BlogDocsLog inGet started
Tessl Logo

verification-before-completion

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

Install with Tessl CLI

npx tessl i github:obra/superpowers --skill verification-before-completion
What are skills?

Overall
score

96%

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Discovery

90%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-structured skill description with strong trigger terms and clear when/what guidance. The main weakness is that the specific verification actions could be more concrete (e.g., 'run tests, check linter output, verify builds'). The phrase 'evidence before assertions always' is a good memorable principle but slightly informal.

Suggestions

Add specific concrete verification actions like 'run tests, check linter, verify build succeeds' to improve specificity

DimensionReasoningScore

Specificity

Names the domain (verification before claims) and some actions ('running verification commands', 'confirming output'), but doesn't list specific concrete actions like 'run tests', 'check linter', 'verify build passes'.

2 / 3

Completeness

Clearly answers both what ('running verification commands and confirming output before making success claims') and when ('about to claim work is complete, fixed, or passing, before committing or creating PRs'). Has explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes natural keywords users/Claude would encounter: 'complete', 'fixed', 'passing', 'committing', 'creating PRs', 'success claims'. These are terms that naturally appear when finishing work.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused on verification before completion claims - distinct from general testing skills or commit message skills. The specific trigger of 'about to claim work is complete' creates a unique activation context.

3 / 3

Total

11

/

12

Passed

Implementation

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an exemplary skill document that teaches a critical behavioral pattern with maximum efficiency. It uses tables, checklists, and concrete examples to make the verification requirement unambiguous and immediately actionable. The document successfully balances thoroughness with conciseness by using structured formats rather than prose.

DimensionReasoningScore

Conciseness

Extremely lean and efficient. Uses tables, bullet points, and minimal prose. Every section earns its place with no explanation of concepts Claude already knows. The repetition is intentional reinforcement for a critical behavioral rule, not padding.

3 / 3

Actionability

Provides concrete gate function with numbered steps, specific command patterns (✅/❌ examples), clear tables mapping claims to requirements, and explicit red flags. The guidance is immediately actionable without ambiguity.

3 / 3

Workflow Clarity

The 5-step gate function is crystal clear with explicit validation checkpoints. The regression test pattern shows a complete red-green verification cycle. Feedback loops are built into the core workflow (verify → if NO → state actual status).

3 / 3

Progressive Disclosure

Well-organized with clear sections (Overview, Gate Function, Common Failures, Red Flags, etc.). For a behavioral skill of this scope (~100 lines), no external references are needed. Content is appropriately structured for quick scanning and reference.

3 / 3

Total

12

/

12

Passed

Validation

88%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata' field is not a dictionary

Warning

license_field

'license' field is missing

Warning

Total

14

/

16

Passed

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.