CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verify-paperclip

Verify Paperclip from a source checkout, published npm install, or existing staging or production stack. Select the environment, data state, version, and platform; drive real UI or CLI journeys and capture evidence. Route deployment to the private Cloud skills.

Quality

86%

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.

A well-structured operational skill with copy-paste-ready commands, a clearly sequenced verification workflow, and abundant validation checkpoints for launch, drive, and teardown safety. Progressive disclosure is exemplary, with detail correctly offloaded to real, well-anchored reference files. The only improvement space is modest tightening of a few repeated caution passages.

DimensionReasoningScore

Conciseness

The body is dense with operationally unique detail (exact prerequisites, isolated data/evidence setup, port/PID ownership checks) and assumes Claude's competence without explaining known concepts like Playwright or PostgreSQL. A few caution passages could be tightened — e.g. the stacked 'does not prove' sentences and the discursive 'Preserve failures through acceptance' subsection — so it fits the 4 anchor ('efficient; minor instances that could be trimmed') rather than the lean 5, and is clearly above 3 since there is no unnecessary concept explanation.

4 / 5

Actionability

Commands are fully executable and copy-paste ready: the mktemp + launch.py invocation with flags, doctor.py, stop.py, onboarding-smoke.mjs, the unittest ownership check, the tsx --help discovery command, and the Playwright chromium install fallback with an env-var override. Concrete routes and selectors (e.g. '/onboarding', '/<PREFIX>/goals') and the described smoke journey cover the common local case, matching the 5 anchor; npm and hosted procedures are appropriately delegated to reference files.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced — select target (dimension checklist plus routing table), launch, doctor, drive, evidence, cleanup — with explicit validation checkpoints (doctor after startup and after surprising behavior, rerun doctor before retry, doctor.json or nonzero exit), error-recovery loops (relaunch a wedged browser, failed-launch evidence retention), and a post-stop verification checklist (no listener, PID exited, evidence files intact). This matches the 5 anchor's explicit validation and feedback loops; the destructive teardown path is safety-validated (port/cwd/ancestry verified before SIGTERM), so no cap applies.

5 / 5

Progressive Disclosure

The SKILL.md body is a clear overview that keeps the common local-launch flow inline and splits detail into three real, well-signaled one-level-deep references with verified anchors ('references/verification-targets.md#checkout-and-data-modes', '#staging-and-production', 'references/npm-install.md', 'references/hosted-qa-accounts.md') plus four helper scripts referenced by exact path. Content is appropriately placed and navigation is easy, matching the 5 anchor rather than 4, since the reference split is clean and no detail that belongs in a reference is inlined.

5 / 5

Total

19

/

20

Passed

Description

75%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 specific, distinctive description with concrete multi-environment actions and clear deployment boundary routing. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which leaves the activation condition only weakly implied and caps completeness. Adding natural trigger phrasing and common synonyms would round it out.

Suggestions

Add an explicit trigger clause, e.g. 'Use when asked to verify, test, or reproduce Paperclip behavior in any environment.'

Include natural user synonyms such as 'test', 'QA', and 'check' alongside 'verify' so the description matches how users actually phrase verification requests.

State when the skill applies relative to the Cloud deployment skills it routes to (e.g. 'Use after deployment when confirming behavior, not for the deploy itself') to sharpen the when-side of the description.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive coverage: 'Verify Paperclip from a source checkout, published npm install, or existing staging or production stack', 'Select the environment, data state, version, and platform', 'drive real UI or CLI journeys and capture evidence', and 'Route deployment to the private Cloud skills'. It matches the 5-anchor ('lists multiple specific concrete actions; comprehensive coverage') rather than 4, because it enumerates every target variant plus the selection, evidence, and routing actions rather than leaving coverage gaps.

5 / 5

Completeness

The 'what' is clear and concrete (verify across source/npm/staging/production, select dimensions, drive journeys, capture evidence), but there is no 'Use when...' clause or equivalent explicit trigger guidance, so 'when' is only weakly implied by the product name. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; it cannot be 4 because the when-usage is never stated explicitly, and it is above 2 because the 'what' is fully clear.

3 / 5

Trigger Term Quality

Good natural keyword coverage — 'verify', 'npm install', 'staging', 'production', 'UI or CLI journeys' are phrases a user would plausibly say — but a few natural synonyms users would actually use are missing ('test', 'QA', 'check the deployment', 'reproduce'). This fits the 4 anchor ('good keyword coverage; a few natural terms missing') better than 3, since the present terms are natural rather than generic, and better than 5, since there is no synonym variation.

4 / 5

Distinctiveness Conflict Risk

The product-specific name 'Paperclip', the enumerated target types, and the explicit boundary 'Route deployment to the private Cloud skills' give it a clear niche with minimal conflict risk against generic verification or deployment skills. It matches the 5 anchor rather than 4 because the deployment boundary is explicitly drawn, not merely implied by topic choice.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 9 suspicious

Warning

Total

15

/

16

Passed

Repository

paperclipai/paperclip

Path

.agents/skills/verify-paperclip/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.