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-completionOverall
score
96%
Does it follow best practices?
Validation for skill structure
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 14 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
Total | 14 / 16 Passed | |
Table of Contents
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.