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.

66

Quality

83%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

The content is a well-sequenced, highly actionable workflow with copy-paste CLI commands, explicit state handling, and concrete output templates, all without padding. Its only weaknesses are mild redundancy between the guardrails and the 'Fluid Workflow Integration' section and a missing end-of-run verification step against the CLI.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout, with no explanations of concepts Claude already knows. Minor trimmable redundancy exists: the 'Fluid Workflow Integration' section repeats the guardrail about updating artifacts when implementation reveals issues, and 'keep changes minimal' appears in both the task loop and the guardrails. Fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than 5.

4 / 5

Actionability

Commands are copy-paste ready with explicit flags (`openspec status --change "<name>" --json`, `openspec instructions apply --change "<name>" --json`), state handling is concrete (`state: "blocked"`, `state: "all_done"`), task completion uses exact checkbox syntax `- [ ]` → `- [x]`, and full output templates cover the common cases. Matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The 7-step sequence is clear with explicit validation via state checks (blocked/all_done) and pause-on-error checkpoints, plus a guardrails checklist. A minor validation gap: the workflow never re-runs `openspec status --json` at the end to verify the recorded progress matches the file edits. Fits 'Clear sequence with most checkpoints present; minor validation gaps' rather than 5.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed for this single-file procedural workflow; sections are well-organized with clear headers and everything inline belongs inline. Minor organization gaps (the redundant closing section and interleaved output templates) keep it at 'Good structure; most content is appropriately placed; minor organization gaps' rather than the cleanly split, well-signaled structure of anchor 5.

4 / 5

Total

17

/

20

Passed

Description

75%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 cleanly answers both what and when with concrete trigger scenarios, in third person and without fluff. Its weaknesses are thin action coverage (only 'implement tasks') and generic trigger phrases that could conflict with ordinary implementation requests outside the OpenSpec niche.

Suggestions

Expand the what-clause with 2-3 more of the skill's concrete actions, e.g., 'Implement tasks from an OpenSpec change: select the active change, read its context files, and mark tasks complete in tasks.md'.

Tie the when-clause to the domain to reduce conflict risk, e.g., 'Use when the user wants to start or continue implementing tasks in an OpenSpec change' rather than generic 'start implementing'.

Add common user phrasings as triggers such as 'apply a change', 'work on the tasks', or 'finish the remaining tasks'.

DimensionReasoningScore

Specificity

"Implement tasks from an OpenSpec change" names the domain and one concrete action, but does not enumerate the several specific actions the skill actually performs (select change, check status, read context files, mark tasks complete). Fits the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than 4, which requires several listed actions.

3 / 5

Completeness

The description explicitly answers both: 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. This matches the anchor for a complete what+when pair, and is not score 4 since the when-clause is already explicit and covers multiple distinct scenarios.

5 / 5

Trigger Term Quality

"start implementing", "continue implementation", and "work through tasks" are natural phrases users would say. A few common variations are missing (e.g., "apply the change", "finish the tasks", "do the tasks"), so it fits 'Good keyword coverage; a few natural terms missing' rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"OpenSpec change" is a distinct niche term, but the trigger phrases "start implementing", "continue implementation", and "work through tasks" are generic and could fire on any implementation request in a non-OpenSpec project, creating real overlap risk with general coding skills. Fits 'Somewhat specific but could still overlap with similar skills' rather than 4, whose minor-overlap examples retain domain-specific triggers.

3 / 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dwmkerr/livedown

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.