CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-prove-it-works

Apply after completing a task, before declaring done. Verify against the real artifact (run the feature, read the actual value, inspect the diff), not a proxy, self-report, or 'it compiles.'

69

Quality

87%

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

86%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 tight, high-signal principle skill: lean prose, concrete verification directives, a clear sequence for code work, and appropriately self-contained structure. The main gap is the absence of even one worked example (e.g., a sample re-runnable check script) to anchor the 'Script the check' guidance.

DimensionReasoningScore

Conciseness

The 26-line body is lean and assumes Claude's competence, adding only non-obvious guidance (e.g., 'Agents report what they intended, not always what happened' and 'suspect the observation method before suspecting the system'). Nothing explains concepts Claude already knows, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Concrete, specific directives throughout — 'Check process liveness directly', 'inspect the actual output artifact (git diff, file contents, runtime behavior)', numbered build/run/check-chain/end-to-end steps — and the code-vs-instruction note means absence of code is not penalized. It sits at 4 rather than 5 because there is no worked example or command (e.g., a sample re-runnable comparison script) covering the common cases.

4 / 5

Workflow Clarity

The 'Code and features' numbered sequence (build → run the actual path → check the full chain → test end-to-end) plus checklist bullets and an error-recovery heuristic ('When verification fails, suspect the observation method') give a clear sequence with most checkpoints present. It is not a destructive/batch skill, so no cap applies; it misses 5 only because the sequence is fully explicit just for code tasks while general tasks get the single 'Pattern' question.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and per the simple-skill guideline well-organized sections suffice: intro/Why/Pattern, a checklist, a delegation section, and a clearly signaled cross-skill pointer ('the **show-me-your-work** skill'). Structure is flat but navigable, matching the 5 anchor for small self-contained skills.

5 / 5

Total

18

/

20

Passed

Description

83%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 strong description: concrete, explicit about both what to do and when to apply it, with distinctive anti-proxy framing and natural trigger phrases. Minor room to broaden keyword coverage and enumerate more verification modes.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'run the feature, read the actual value, inspect the diff' — plus explicit anti-examples ('not a proxy, self-report, or "it compiles"'). Coverage is good but not comprehensive (e.g., process liveness or end-to-end paths named in the body are absent), matching the 'several specific actions; minor gaps' anchor rather than the 5 anchor's full coverage.

4 / 5

Completeness

It explicitly answers both questions: when ('Apply after completing a task, before declaring done') and what ('Verify against the real artifact... not a proxy, self-report, or "it compiles"') with concrete trigger phrases. This matches the 5 anchor; the 4 anchor applies when the 'when' is generic like 'Use when working with PDF files', whereas here the trigger timing is explicit and specific.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present ('verify', 'run the feature', 'inspect the diff', 'self-report', "'it compiles'"), giving good keyword coverage. It stays at 4 rather than 5 because common variations like 'prove', 'test', or 'check before done' are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (direct verification vs. proxies/self-reports) is distinct with memorable triggers, but 'Apply after completing a task' is broadly applicable and could overlap with completion-adjacent skills (review/run/verify skills). Mostly distinct with minor overlap risk fits the 4 anchor better than 5's 'minimal conflict risk'.

4 / 5

Total

17

/

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

adamsardo/pstack-claude

Path

plugins/pstack/skills/principle-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.