CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-apply-change

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/openspec-apply-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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, actionable workflow document with concrete commands, state handling, and clear output templates. Its main weakness is the batch task loop lacking a verification checkpoint before marking tasks complete, plus minor redundancy between the Guardrails section and Step 6's pause conditions.

Suggestions

Add a verification step in the task loop (e.g., run tests or `openspec validate` before marking a task '- [x]') so the batch implementation workflow has an explicit validation checkpoint.

Merge the 'Guardrails' section with the Step 6 'Pause if' conditions to remove the duplicated guidance and reduce token cost.

Include a short sample of the `openspec instructions apply --json` output (contextFiles, progress, state fields) so the parsing step is fully executable without guessing the shape.

DimensionReasoningScore

Conciseness

The body is lean and procedural with no explanation of concepts Claude already knows, and output templates are token-efficient. Minor redundancy exists: the 'Guardrails' section largely restates the pause conditions already detailed in Step 6, which keeps it below the 'every token earns its place' anchor 5.

4 / 5

Actionability

Provides copy-paste-ready CLI commands ('openspec status --change "<name>" --json', 'openspec instructions apply --change "<name>" --json'), a concrete edit instruction ('- [ ]' → '- [x]'), and concrete output templates. Minor gaps (no sample JSON output, no example of a task line) keep it below fully-executable anchor 5.

4 / 5

Workflow Clarity

The 7-step sequence is clearly ordered with explicit state handling (blocked, all_done) and pause conditions, which exceeds anchor 3's sequence quality. However, the task loop is a batch operation over multiple tasks with no validation/verification step (e.g., run tests or check the change before marking '- [x]'), which caps the score at 3 per the rubric's batch-operation guideline.

3 / 5

Progressive Disclosure

The skill is self-contained with no bundle files; content is well-sectioned (Steps, Outputs, Guardrails, Fluid Workflow) and all of it appropriately belongs in SKILL.md rather than separate files. At ~150 lines it exceeds the under-50-line simple-skill exception, so it sits at anchor 4 rather than 5.

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 concise, well-formed description that clearly states what the skill does and when to use it, with distinct anchoring to the OpenSpec niche. It could broaden its action coverage and trigger synonyms slightly, but avoids fluff and over-claiming entirely.

DimensionReasoningScore

Specificity

Names the domain ('an OpenSpec change') and one concrete action ('Implement tasks'), matching the '1-2 concrete actions' anchor. It does not list several specific actions (e.g., reading context files, marking tasks complete), so it falls short of anchor 4.

3 / 5

Completeness

Explicitly answers 'what' ('Implement tasks from an OpenSpec change') and 'when' ('Use when the user wants to start implementing, continue implementation, or work through tasks') with concrete trigger phrases, matching the anchor 5 example structure. Not below 5 since neither half is vague or merely implied.

5 / 5

Trigger Term Quality

Includes natural user phrasings like 'start implementing', 'continue implementation', and 'work through tasks'. Coverage is good but misses common synonyms such as 'apply the change', 'execute tasks', or 'finish the change', so it is not the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The 'OpenSpec change' niche is clearly distinct from generic skills, and triggers are anchored to implementation rather than planning or archiving. Minor overlap risk remains with closely related sibling skills (e.g., openspec-continue-change), keeping it below anchor 5.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

PBH-BTN/PeerBanHelper

Path

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