CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-verify-change

Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.

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 ./.claude/skills/openspec-verify-change/SKILL.md

The canonical home for this skill is openspec-verify-change in dwmkerr/git-workforest

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 strong, highly actionable single-file workflow: exact CLI commands, parse markers, issue templates, and a degradation ladder make it essentially copy-paste executable with clear validation checkpoints. The only real weakness is redundancy — the "Issues by Priority" and parts of the "Verification Heuristics" sections restate what the numbered steps already prescribe.

Suggestions

Collapse the "Issues by Priority" section into a one-line severity definition (CRITICAL = must fix before archive, WARNING = should fix, SUGGESTION = nice to fix) and drop the re-enumeration of issue contents already given in steps 5–7 — this trims ~15 redundant lines.

Trim the "Verification Heuristics" lines that restate step guidance (e.g., 'Completeness: Focus on objective checklist items') and keep only the genuinely new rules (false-positive preference, actionability requirement).

Consider moving the verification report template (the scorecard table and final-assessment wording) into a short reference or asset file so SKILL.md stays a lean process overview.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural instruction with no explanation of concepts Claude already knows, but it can be noticeably tightened: the "Issues by Priority" section re-enumerates the CRITICAL/WARNING/SUGGESTION contents already fully specified in steps 5–7 ('Incomplete tasks', 'Missing requirement implementations', 'Spec/design divergences', 'Missing scenario coverage'), and parts of "Verification Heuristics" ('Focus on objective checklist items', 'Use keyword search...') restate the step instructions. This is anchor 3 ('could be tightened') rather than anchor 4's 'minor instances' — the redundancy spans whole sections, not isolated lines — and well above anchor 2's padded explanations.

3 / 5

Actionability

Guidance is fully executable: exact copy-paste commands ('openspec list --json', 'openspec status --change "<name>" --json', 'openspec instructions apply --change "<name>" --json'), exact artifact paths ('openspec/changes/<name>/specs/'), exact parse markers ('### Requirement:', '#### Scenario:', '- [ ]' vs '- [x]'), a fixed issue taxonomy with literal message templates ('Requirement not found: <requirement name>'), and a concrete output format. Per the rubric's instruction-only-skill note, the absence of code is not penalized since the guidance is copy-paste-level actionable, matching anchor 5.

5 / 5

Workflow Clarity

Eight numbered steps in a clear sequence with explicit input handling up front ('Do NOT guess or auto-select a change'), a graceful-degradation ladder for missing artifacts ('If only tasks.md exists: verify task completion only... Always note which checks were skipped'), and an explicit final-assessment decision rule ('If CRITICAL issues... If only warnings... If all clear'). These are the validation checkpoints, error-recovery paths, and checklists anchor 5 requires; the skill is itself a verification workflow, so no validation gap remains, keeping it above anchor 4.

5 / 5

Progressive Disclosure

No bundle files exist and the body is well organized with numbered steps and distinct sections (Verification Heuristics, Graceful Degradation, Output Format), so nothing is buried. However, at ~155 lines it exceeds the simple-skill threshold that would let a single well-organized file score 5, and content like the report template and the per-dimension issue-generation rules could arguably live in reference files. That leaves minor organization/split opportunities, fitting anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps') rather than anchor 5's 'appropriately split' ideal.

4 / 5

Total

17

/

20

Passed

Description

62%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 correctly pairs an explicit 'what' with an explicit 'Use when...' clause in third person, with no fluff. Its main weaknesses are the single-verb capability statement (verify/validate with adjectives rather than enumerated actions) and a thin trigger vocabulary that misses natural user phrasings like 'check the change' or 'ready to archive'.

Suggestions

Enumerate the concrete verification actions, e.g. 'Checks task completion, verifies spec/requirement coverage, maps requirements to implementation code, validates design adherence, and generates a readiness report' — this raises specificity from one generic verb to several listed actions.

Broaden trigger terms with natural variations users would actually say: 'check the change', 'review the change specs/tasks', 'is the change done', or 'ready to archive' alongside the existing 'validate ... before archiving'.

Mention the report output and artifact types (specs, tasks, design) in the 'what' clause so the scope of the skill is concrete without reading the body.

DimensionReasoningScore

Specificity

The description names the domain ("change artifacts") and one concrete action ("Verify implementation matches change artifacts") plus the qualifiers "complete, correct, and coherent", but these are dimension adjectives rather than distinct listed actions (e.g., no mention of checking tasks, mapping requirements to code, or generating a report). This matches anchor 3 ('Names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4, which expects several specific enumerated actions like 'Extracts text from PDF files, fills forms, converts pages to images'.

3 / 5

Completeness

Both parts are explicitly present: 'what' ("Verify implementation matches change artifacts") and 'when' ("Use when the user wants to validate that implementation is complete, correct, and coherent before archiving"). This clearly exceeds anchor 3 (what without when) but falls short of anchor 5, which requires concrete trigger-phrase variety like 'PDF files, PDFs, forms' — here the trigger is a single narrow condition with no synonyms or alternative phrasings.

4 / 5

Trigger Term Quality

Relevant natural keywords are present ("verify", "validate", "implementation", "before archiving"), but common variations a user would actually say are missing (e.g., "check the change", "review the specs/tasks", "is the change done", "ready to archive"). This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms'), not anchor 4's 'Good keyword coverage; a few natural terms missing' — the gap is more than a few terms.

3 / 5

Distinctiveness Conflict Risk

"change artifacts" and "before archiving" anchor the skill to the openspec change-workflow niche, making it mostly distinct. It does not reach anchor 5 ('clear niche with distinct triggers; minimal conflict risk') because the bare phrase "Verify implementation" could plausibly fire for a generic code-review or test-verification request outside an openspec context — a minor overlap risk with closely related skills, matching anchor 4.

4 / 5

Total

14

/

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

dwmkerr/livedown

Path

.claude/skills/openspec-verify-change/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.