CtrlK
BlogDocsLog inGet started
Tessl Logo

openspec-verify-change

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

62

Quality

73%

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

67%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 detailed, well-sequenced verification workflow with concrete CLI commands and clear prioritization. Its main weakness is verbosity in the report-template and recommendation-phrasing sections, plus a few heuristic steps that stay abstract.

Suggestions

Tighten the report template and the repeated per-issue recommendation phrasings into a compact schema or example rather than prose, to improve conciseness.

Make the 'Spec Coverage' and 'Scenario Coverage' search steps more executable by specifying concrete search strategies (e.g., ripgrep patterns against requirement keywords) instead of 'search codebase for keywords'.

Add an explicit feedback loop: after generating the report, offer to re-verify a specific issue once the user addresses it, to strengthen validation checkpoints for the batch iteration over requirements and scenarios.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural content with little concept-padding, but the ~150 lines spell out report templates and per-issue recommendation phrasings that could be tightened without losing clarity.

3 / 5

Actionability

It provides concrete, executable commands ('openspec list --json', 'openspec status --change', 'openspec instructions apply') and precise parsing rules ('- [ ]' vs '- [x]'), but a few steps remain abstract ('search codebase for keywords', 'assess if implementation likely exists').

4 / 5

Workflow Clarity

The process is clearly sequenced across eight numbered steps with prioritization tiers (CRITICAL/WARNING/SUGGESTION) and false-positive guidance acting as checkpoints, though explicit validate-fix-retry feedback loops are only implied.

4 / 5

Progressive Disclosure

The body is self-contained (no bundle files exist) and well-organized into clearly labeled sections (Steps, Verification Heuristics, Graceful Degradation, Output Format); the embedded report template could arguably live in a reference file, a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

78%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 pairs a clear statement of what the skill does with an explicit 'Use when' trigger clause. It is concrete and distinctive, with only minor room to add more varied trigger terms and list more specific actions.

DimensionReasoningScore

Specificity

It names the domain ('implementation matches change artifacts') and one concrete action (verify matches) plus the three verification dimensions ('complete, correct, and coherent'), but coverage of concrete actions is limited rather than comprehensive.

3 / 5

Completeness

It explicitly answers both what ('Verify implementation matches change artifacts') and when ('Use when the user wants to validate that implementation is complete, correct, and coherent before archiving') with a concrete trigger clause.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('Use when the user wants to validate', 'implementation is complete', 'before archiving'), giving good keyword coverage, though a few common synonyms/variations are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (verifying openspec change artifacts before archiving) is mostly distinct with clear triggers, carrying only minor overlap risk with closely related spec/code-review skills.

4 / 5

Total

16

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
dwmkerr/openspec-flow
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.