CtrlK
BlogDocsLog inGet started
Tessl Logo

openspec-apply-change

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

59

Quality

68%

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 clearly sequenced, actionable skill body with concrete CLI commands and good structural organization. Its main weakness is the absence of explicit validation/verification checkpoints in a batch task-implementation loop, which the rubric caps at workflow clarity 3.

Suggestions

Add an explicit validation step after each task (e.g., run tests / typecheck / build) before marking the checkbox complete, with a fix-and-retry loop on failure.

Trim the duplicated output templates (completion and pause) or collapse them into a single parameterized example to save tokens.

Include a small sample of the JSON fields returned by `openspec status`/`openspec instructions` so parsing is unambiguous.

DimensionReasoningScore

Conciseness

The body is well-structured with minimal preamble and avoids re-explaining concepts Claude already knows; a few sections (e.g., the repeated state-handling bullets and lengthy output templates) could be trimmed slightly.

4 / 5

Actionability

It provides concrete, executable CLI commands (e.g., `openspec status --change "<name>" --json`, `openspec instructions apply ...`) plus a precise checkbox-update mechanic, with only minor gaps such as no example of the JSON shape to parse.

4 / 5

Workflow Clarity

Steps are clearly sequenced with state-handling branches and pause conditions, but this batch task-implementation workflow lacks explicit validation checkpoints (e.g., running tests or verifying a build before marking each task complete), capping it at 3 per the destructive/batch guidance.

3 / 5

Progressive Disclosure

Content is organized into clear labeled sections with example outputs and guardrails, and there are no nested or buried references; absence of any bundle files means it relies entirely on the well-organized inline structure with only minor organization gaps.

4 / 5

Total

15

/

20

Passed

Description

67%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 solid, third-person description that states the skill's purpose and provides an explicit 'Use when' trigger clause. It is somewhat narrow in trigger-term coverage and enumerates only one headline action.

Suggestions

Broaden trigger terms to include natural phrasings like 'code the change', 'build out the spec', or 'finish implementing the OpenSpec change'.

Mention 1-2 supporting actions (e.g., marking task checkboxes, reading context files) to improve specificity coverage.

Tighten the 'when' clause by tying it to explicit user intents like 'when the user asks to start, resume, or complete task implementation'.

DimensionReasoningScore

Specificity

It names the concrete action ('Implement tasks from an OpenSpec change') rather than vague abstraction, but lists only one primary action with no enumeration of supporting behaviors, leaving minor coverage gaps.

4 / 5

Completeness

It states clearly what the skill does ('Implement tasks from an OpenSpec change') and gives an explicit 'Use when' clause with concrete triggers, but the when-conditions are moderately generic and could be more specific.

4 / 5

Trigger Term Quality

It includes the natural phrase 'start implementing, continue implementation, or work through tasks', but omits common synonyms (e.g., 'build', 'coding', 'code the change') and references only the OpenSpec artifact term rather than user-facing variations.

3 / 5

Distinctiveness Conflict Risk

The OpenSpec-specific framing gives it a clear niche distinct from generic coding skills, with only minor overlap risk against a sibling 'continue-change' skill mentioned in the body.

4 / 5

Total

15

/

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
PBH-BTN/PeerBanHelper
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.