CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prove-it-works

Prove a task against the real artifact before calling it done. Use during factory-work, before ready_for_review, and whenever a check only shows that code compiles or a file changed.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a tight, high-signal instruction skill: it states the principle, gives concrete verification directives, provides a decision rule for when a script-based proof is warranted, and covers edge cases (static files, artifact retention, UI tasks) without padding. Its only gap is the lack of a concrete example of the re-runnable proof script it advocates.

DimensionReasoningScore

Conciseness

The ~20-line body is lean with no padding and no explanation of concepts Claude already knows — every line ("Check process liveness directly, not through a derived 'it should be up.'", "When a check fails, suspect the observation method before suspecting the product") adds non-obvious, project-specific guidance. It matches the anchor-5 'every token earns its place' case; anchor 4's 'minor instances of over-explanation' does not apply.

5 / 5

Actionability

The guidance is concrete and directive — "Run the feature, read the actual value, and inspect the diff", "reading back its exact bytes is the proof", with a clear decision rule for when to write a proof script versus when reading suffices. Per the rubric's instruction-skill note the absence of code is not penalized, but it stops short of fully executable copy-paste material (e.g., no example of what a re-runnable comparison script looks like), which keeps it below anchor 5.

4 / 5

Workflow Clarity

This is a simple single-purpose skill and its single action — verify the real artifact, not proxies — is unambiguous, with an explicit failure-handling rule ("suspect the observation method before suspecting the product") and clear conditionals for script vs. byte-read proof, artifact visibility, and when to commit. Under the rubric's simple-skill exception the single action being unambiguous warrants a 5; the operations are not destructive or batch, so no cap applies.

5 / 5

Progressive Disclosure

The skill is under 50 lines, requires no external references (none exist in the bundle), and is well organized into a header, a concrete checklist, a decision rule for proofs, and scoped special cases (commit policy, UI tasks). This matches the rubric's guideline that short skills with no need for external files can score 5 with well-organized sections alone.

5 / 5

Total

19

/

20

Passed

Description

71%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 cleanly answers both what the skill does and when to use it, with explicit, concrete trigger conditions. Its weaknesses are a thin capability statement (one abstract action instead of the specific checks it covers) and trigger terms that lean on internal workflow jargon rather than natural user language.

Suggestions

Enumerate one or two concrete capabilities in the description (e.g., 'Runs the feature, reads back actual values, and inspects the real diff') so the 'what' goes beyond the single abstract action 'prove a task'.

Add natural-language trigger synonyms alongside the workflow jargon, such as 'verify', 'test that it works', or 'before calling a task done', so users phrasing the need generically still match.

Clarify what 'the real artifact' means at the description level (the output the user touches) to reduce overlap with generic testing/verification skills.

DimensionReasoningScore

Specificity

"Prove a task against the real artifact" names the domain (verification) and one core action, but the description never enumerates the concrete verification actions (run the feature, read values, inspect diffs, check liveness) that the body actually covers. Not a 4 because it does not list several specific actions; not a 2 because the action stated is more concrete than a generic 'handles verification'.

3 / 5

Completeness

The 'what' is clearly stated ("Prove a task against the real artifact before calling it done") and the 'when' is explicit with concrete trigger phrases ("Use during factory-work, before ready_for_review, and whenever a check only shows that code compiles or a file changed"). Both halves are explicitly present, matching the anchor-5 example structure; anchor 4's caveat (a less explicit 'when') does not apply.

5 / 5

Trigger Term Quality

Triggers like "factory-work", "ready_for_review", "code compiles", and "file changed" are relevant to this workflow but are internal jargon rather than natural user phrasings, and common variations ("verify", "test it", "before you call it done") are absent. Anchor 4 is not reached because keyword coverage lacks natural synonyms beyond the workflow-specific terms.

3 / 5

Distinctiveness Conflict Risk

The niche (artifact-level proof vs. proxy checks) is distinct and its triggers are tied to specific workflow states, giving it a clear identity. However, "prove a task" and failure-checking guidance could overlap with generic testing/verification skills, so it falls short of minimal conflict risk at anchor 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

geut/factory-skills

Path

skills/prove-it-works/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.