CtrlK
BlogDocsLog inGet started
Tessl Logo

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. Also use when the user says "openspec continue" or "opsx continue".

68

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An instruction-only skill body that is exceptionally actionable and workflow-safe: exact CLI commands, JSON field contracts, validation checkpoints, and guardrails against side effects (never auto-creating the openspec/ root). Its only costs are mild redundancy (repeated constraint guidance, a dense store-flag paragraph) and a fully inlined structure that a slightly larger skill might split into a reference file.

DimensionReasoningScore

Conciseness

Nearly every paragraph is operational (command flags, JSON fields, branch handling) and assumes Claude's competence rather than explaining concepts. Minor trimming opportunities exist: the 'context and rules are constraints, not content' guidance appears twice (in step 3 and again in Guardrails), and the store-selection paragraph is convoluted ('Every unscoped example of those commands below is shorthand...'), which keeps it at 'minor instances of over-explanation' rather than the lean 5 anchor.

4 / 5

Actionability

Fully executable guidance throughout: exact commands with flags (`openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`), the exact JSON fields to read (`schemaName`, `artifacts`, `isPlanningComplete`, `resolvedOutputPath`), and concrete handling for edge cases like glob output paths and `skipped` artifacts. It is not the 4 anchor because no pseudocode or missing key details were found.

5 / 5

Workflow Clarity

A clear numbered sequence (select change -> check status -> act by status -> show progress) with explicit validation checkpoints: parse status JSON before acting, verify the artifact file exists at `resolvedOutputPath` after writing, re-read dependencies from disk rather than conversation memory, and STOP rules bounding each invocation. Error-recovery branches (root: null handling, store-declaration errors, the 'no artifacts ready' fallback) match the top anchor's feedback-loop standard.

5 / 5

Progressive Disclosure

The body is self-contained with no bundle files (no references/, scripts/, or assets/ exist) and is organized into well-labeled sections (Store selection, Project check, Input, Steps, Output, Guidelines, Guardrails) with no buried or nested references. At ~116 lines it exceeds the under-50-lines simple-skill case, and some material (store-selection mechanics, the multi-branch project-check matrix) could plausibly live in a reference file, which holds it at 'good structure; minor organization gaps' rather than the ideal split of 5.

4 / 5

Total

18

/

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 compact, third-person description that answers 'what' and 'when' explicitly, with excellent literal command aliases as triggers. Its only weakness is thin capability enumeration - it names one action rather than several concrete ones.

Suggestions

Enumerate one or two more concrete capabilities (e.g., 'reads the next artifact's instructions, applies its template, and writes it to the resolved path') to lift specificity from one action to several.

Add a common natural phrasing such as "resume work on a change" or "pick up an in-progress change" to broaden trigger coverage beyond the literal commands.

Disambiguate from sibling OpenSpec skills by keeping the 'next artifact / continue' framing dominant, since it is the description's main differentiator.

DimensionReasoningScore

Specificity

"Continue working on an OpenSpec change by creating the next artifact" names the domain and exactly one concrete action; there is no enumeration of what artifact creation involves (e.g., reading instructions, applying templates), so it matches the '1-2 concrete actions, not comprehensive' anchor rather than the 'several specific actions' anchor at 4.

3 / 5

Completeness

Both halves are explicit: 'what' is stated first ("Continue working on an OpenSpec change by creating the next artifact") and 'when' is given with concrete trigger phrases ("Use when the user wants to progress their change... Also use when the user says 'openspec continue' or 'opsx continue'"). This matches the top anchor; it is not the 4 anchor because the 'when' clause is not merely present but specific and multi-phrased.

5 / 5

Trigger Term Quality

Strong natural triggers including literal command aliases ("openspec continue", "opsx continue") plus "progress their change", "create the next artifact", "continue their workflow". A few natural user phrasings (e.g., "keep going on the change", "pick up where I left off") are absent, so it sits at 'good coverage; a few natural terms missing' rather than comprehensive at 5.

4 / 5

Distinctiveness Conflict Risk

"OpenSpec change", "artifact", and the exact commands "openspec continue"/"opsx continue" form a clear niche with minimal generic overlap. It stays at 4 rather than 5 because sibling OpenSpec skills (create/new-change, archive, list) plausibly share the same 'OpenSpec' trigger vocabulary, creating minor overlap risk with closely related 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Fission-AI/OpenSpec
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.