CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-verification-skill

Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform. Use for /create-verification-skill, "make a control skill for this repo", or when a project has no scripted way to prove UI/CLI/service behavior.

64

Quality

80%

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 ./.agents/skills/create-verification-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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-crafted generator skill: tight imperative prose, a concrete contract for the artifact it produces, a full validation loop, and an exemplary referenced example directory. Its only structural defect is two links that do not resolve within the bundle being evaluated.

Suggestions

Fix or remove the dangling links: NOTICE.md is absent from the bundle and ../../../maps/README.md points outside it — against the actual bundle structure both are dead references.

Merge the two consecutive 'For Paperclip' paragraphs in section 3 (and consider moving that repo-specific guidance to a reference file) to tighten the body and keep the section's generic path uncluttered.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes Claude's competence (e.g., 'Prefer the repo's own documented dev command (package scripts, Makefile, README quickstart)'); it never explains concepts Claude already knows. Minor trimming is possible — section 3 splits its Paperclip guidance across two consecutive 'For Paperclip' paragraphs, and a few long clauses could be tightened — so it sits at 'efficient; minor instances that could be trimmed' rather than 'every token earns its place'.

4 / 5

Actionability

Concrete, specific instructions throughout: exact output paths ('.agents/skills/verify-<app>/SKILL.md'), the required frontmatter, six named sections with their content contracts, the exact four H2s for feature files, and a runnable check ('node scripts/check-maps.mjs'). As an instruction-only generator skill the absence of literal code is justified — the commands depend on each repo — and the real, high-quality references/feature-map-example/ bundle makes the target shape concrete. It stops short of copy-paste-ready commands, capping it below 5.

4 / 5

Workflow Clarity

A clear five-step sequence (interview → generate → seed map → prove → offer maintenance) with explicit validation and feedback loops: 'If the checkout doesn't build or start as-is, fix that first... before generating', step 4's end-to-end trial run, 'Fix what fails, and run the generated cleanup after every failed iteration too, so broken attempts don't strand processes and ports', and the post-cleanup check that evidence survived. This matches the top anchor: sequenced steps with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

Good structure: a ~58-line overview body with the detailed material correctly split into references/feature-map-example/ (README plus two feature files), clearly signaled one level deep via '[references/feature-map-example/](references/feature-map-example/)' — a real directory whose contents match the promised shape (four ordered H2s, README index). Scored against the actual bundle, two referenced paths dangle: NOTICE.md is not present in the bundle, and ../../../maps/README.md resolves outside it, leaving minor organization gaps that hold this below a 5.

4 / 5

Total

17

/

20

Passed

Description

73%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 that explicitly answers both what it does and when to use it, with natural, distinctive trigger phrases. Its weaknesses are the second-person 'your app' (a voice violation the rubric penalizes on specificity) and reliance on a single generate-action rather than an enumerated list of capabilities.

Suggestions

Rewrite in third person to avoid the voice penalty: e.g., 'Generate a project-local verification skill that drives the app the way a user does' (drop 'your').

Enumerate the concrete capabilities instead of one action: e.g., 'Interviews the repo for launch/drive/evidence options, generates the verification skill, seeds a feature map, and proves it end to end'.

Add one or two natural synonyms users might say, such as 'e2e harness', 'smoke-test the app', or 'app control skill', to broaden trigger coverage.

DimensionReasoningScore

Specificity

Base score 3: it names the domain ('project-local verification skill') with 1-2 concrete actions ('Generate...', 'drives... the way a user does') plus scope ('any language, framework, or platform'), matching 'names domain and 1-2 concrete actions'. The rubric's voice rule then applies: 'drives your app the way a user does' is second person, so specificity is reduced by 1 to 2. It is not a 1 — the domain and action are concrete, not 'Helps with documents'-level vagueness.

2 / 5

Completeness

Both halves are explicit: what — 'Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform'; when — 'Use for /create-verification-skill, "make a control skill for this repo", or when a project has no scripted way to prove UI/CLI/service behavior'. This matches the top anchor: a clear what and a clear when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good keyword coverage with genuinely natural user phrasing: '/create-verification-skill', '"make a control skill for this repo"', and 'when a project has no scripted way to prove UI/CLI/service behavior', plus surface terms (UI/CLI/service). A few natural synonyms users might say are missing (e.g., 'e2e harness', 'smoke test', 'app control'), which holds it below the comprehensive anchor 5; it clearly exceeds 'some relevant keywords but missing common variations'.

4 / 5

Distinctiveness Conflict Risk

A distinct niche (generating a repo-tailored verification/control skill) with distinctive triggers ('make a control skill for this repo', 'no scripted way to prove... behavior'). Minor overlap risk remains with closely related skills around running/testing the app (e.g., a generic 'run the app' or e2e-testing skill), so it is 'mostly distinct' rather than a clear-niche 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

paperclipai/paperclip

Path

.agents/skills/create-verification-skill/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.