CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verification-before-completion

Internal verification gate for delivery-flow. Use before delivery-flow claims work is complete, fixed, or passing; do not activate directly for a standalone user request.

61

Quality

77%

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 ./00-activation-testing/before/plugins/sdlc-assurance/skills/verification-before-completion/SKILL.md

The canonical home for this skill is verification-before-completion in obra/superpowers

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.

A strongly structured behavioral gate: the workflow itself is exemplary, with an explicit verified-checkpoint sequence, failure feedback, and concrete evidence mappings. The main cost is redundancy — the same failure modes are hammered out across four overlapping sections where one consolidated table plus one pattern section would preserve the effect at roughly 60% of the tokens.

Suggestions

Merge Red Flags, Rationalization Prevention, and Common Failures into a single claim-vs-evidence (or excuse-vs-action) table — the same items ('just this once', trusting agent reports, 'should work now') currently appear in multiple sections.

Trim Key Patterns to only the claims not already covered by Common Failures (regression red-green and agent delegation are the two that add new content) and cut the duplicated test/build examples.

DimensionReasoningScore

Conciseness

Individual lines are lean and no space is spent explaining concepts Claude already knows, but the document restates the same failure modes across multiple sections — 'just this once' and 'trusting agent reports' each appear 3-4 times across Red Flags, Rationalization Prevention, Common Failures, and Key Patterns. This fits anchor 3 ('mostly efficient but could be tightened'), not anchor 2 since there is no unnecessary concept explanation or padding prose.

3 / 5

Actionability

The Gate Function is a concrete 5-step procedure with decision branches, the Key Patterns give explicit ✅/❌ examples, and the red-green regression sequence ('Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)') is fully specified. It falls at anchor 4 rather than 5 only because the examples use placeholders ('[Run test command]') rather than literal executable commands — minor gaps, though context-dependence is inherent to a meta-skill.

4 / 5

Workflow Clarity

The Gate Function lays out a clear sequence (IDENTIFY → RUN → READ → VERIFY → claim only then) with an explicit verification checkpoint and a failure feedback branch ('If NO: State actual status with evidence'), and the Common Failures table maps each claim type to its required evidence. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery'), and verification is the skill's entire subject.

5 / 5

Progressive Disclosure

The skill is a self-contained behavioral gate with no bundle files and nothing that belongs in external references — the gate must load in full to work — and the body is organized into clear, navigable sections (Iron Law, Gate Function, Common Failures, Red Flags, Key Patterns, When To Apply). Content is appropriately placed in a single file, matching the top anchor's intent of appropriate structure and easy navigation.

5 / 5

Total

17

/

20

Passed

Description

66%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 well-scoped, third-person description with an explicit trigger clause and strong boundary guidance against wrong activation. Its main weakness is that it states what the skill is rather than what it concretely does, and its trigger vocabulary covers only a few of the natural claim phrasings.

Suggestions

Add 1-2 concrete actions the gate performs, e.g., 'Runs the proving command, reads full output, and checks exit codes before any completion claim' to raise specificity and make the 'what' fully concrete.

Broaden trigger coverage with common synonyms users and flows naturally say: 'done', 'works', 'all tests pass', 'succeeds', alongside the existing 'complete, fixed, or passing'.

DimensionReasoningScore

Specificity

The description names the domain ('Internal verification gate for delivery-flow') and a concrete scope ('claims work is complete, fixed, or passing'), but describes only 1-2 concrete elements rather than a list of specific actions. It fits anchor 3 ('names domain and 1-2 concrete actions'); it is not anchor 4 because it never states what the gate actually does (e.g., run commands, read output, check exit codes), and not anchor 2 because the claim types give it more specificity than a bare domain statement.

3 / 5

Completeness

Both parts are present: what ('Internal verification gate for delivery-flow') and an explicit when ('Use before delivery-flow claims work is complete, fixed, or passing') plus an activation boundary ('do not activate directly for a standalone user request'). It stops short of anchor 5 because the 'what' is somewhat abstract — it says what the skill is, not what it does — which is the anchor-4 pattern ('when' explicit, 'what' could be more concrete).

4 / 5

Trigger Term Quality

'complete, fixed, or passing' are natural phrases, but common variations and synonyms are missing ('done', 'works', 'tests green', 'all set'). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'), short of anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

It is scoped to a specific parent flow ('delivery-flow') and explicitly excludes standalone activation ('do not activate directly for a standalone user request'), giving a clear niche with minimal conflict risk — anchor 5. It is not anchor 4 because the boundary guidance is already explicit rather than leaving minor overlap risk.

5 / 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

tesslio/tessl-eval-demo

Path

00-activation-testing/before/plugins/sdlc-assurance/skills/verification-before-completion/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.