CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-continue-change

Continue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change, create the next artifact, or continue their workflow.

64

Quality

81%

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

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.

A well-structured, highly actionable workflow skill: concrete CLI commands with expected JSON fields, explicit status-driven branching, and useful guardrails. Its only weaknesses are minor repetition between the steps and Guardrails sections and a weak error-recovery path for the 'all blocked' state.

DimensionReasoningScore

Conciseness

The body is lean and command-first with no explanations of concepts Claude already knows, but a few points are repeated — 'context and rules are constraints, do NOT copy them into the file' appears in step 3 and again in Guardrails, and 'create ONE artifact per invocation' is stated at both line 72 and line 110. Minor trimming would reach anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with exact flags ('openspec list --json', 'openspec status --change "<name>" --json', 'openspec instructions <artifact-id> --change "<name>" --json'), precise JSON fields to parse, a concrete AskUserQuestion presentation spec, and clear output-path guidance. Specific examples cover the common cases (all complete / ready / blocked).

5 / 5

Workflow Clarity

A clear numbered sequence with three explicit status branches, a STOP rule after one artifact, and a verify guardrail ('Verify the artifact file exists after writing before marking progress'). However, the 'all blocked' branch offers only 'suggest checking for issues' with no real feedback loop, leaving a minor validation gap versus anchor 5.

4 / 5

Progressive Disclosure

The single self-contained file is well organized (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no nested references and nothing requiring external files. At ~107 lines it exceeds the simple-skill note, and the spec-driven artifact patterns section could arguably move to a reference file, so it fits anchor 4's 'good structure; minor organization gaps' rather than a clean 5.

4 / 5

Total

17

/

20

Passed

Description

70%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 description with an explicit 'Use when' clause, third-person voice, and a clearly pinned domain. Its main weakness is that the trigger guidance is somewhat circular — the 'when' clause restates the 'what' — and it lists only one concrete action.

Suggestions

List the concrete artifacts in the description (e.g., 'create the next artifact — proposal, specs, design, or tasks') to raise specificity and give users recognizable nouns to say.

Add natural trigger variations users would actually say, such as 'next step', 'keep going with the change', or 'write the spec/proposal/tasks', instead of restating 'create the next artifact' in the when-clause.

Trim the generic tail 'or continue their workflow' — it adds overlap risk with other workflow-continuation skills without adding trigger value beyond 'progress their change'.

DimensionReasoningScore

Specificity

Names the domain ('OpenSpec change') and one concrete action ('creating the next artifact'), but 'Continue working on' is generic and no other specific actions are listed — matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions (artifact types like proposal, specs, design, tasks) that would reach anchor 4.

3 / 5

Completeness

Both 'what' (continue an OpenSpec change by creating the next artifact) and 'when' (explicit 'Use when the user wants to progress their change...') are present. However, the 'when' clause largely restates the 'what' rather than offering distinct concrete trigger phrases, so it matches anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Natural phrases like 'progress their change', 'create the next artifact', and 'continue their workflow' give good keyword coverage, but common user variations ('next step', 'proposal', 'spec', 'keep going') are missing. It falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'OpenSpec change' pins a clear niche with minimal conflict risk, but the generic tail 'or continue their workflow' could overlap with other continue-style workflow skills. Mostly distinct with minor overlap risk — anchor 4, not the clear-niche anchor 5.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dwmkerr/livedown

Path

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