CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-new-change

Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.

63

Quality

79%

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

Fix and improve this skill with Tessl

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

Quality

Content

78%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, instruction-style body: concrete commands, a clear sequence with an explicit stop point, and a useful guardrails section. The only real weaknesses are a thrice-repeated --schema instruction and the absence of a verify-succeeded feedback loop after the scaffold command.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no concept explanations Claude would already know; commands are given without padding. It is not a 5 because the --schema guidance is repeated three times (step 2, step 3, and the guardrails' 'Pass --schema if using a non-default workflow'), which could be trimmed to one statement.

4 / 5

Actionability

Concrete, copy-paste-ready CLI commands are given for each phase ('openspec new change "<name>"', 'openspec status --change "<name>"', 'openspec instructions <first-artifact-id> --change "<name>"'), plus the exact open-ended question text to ask. It is not a 5 because minor gaps remain: no example with a concrete change name, and no guidance for handling CLI failures (e.g., invalid name errors beyond the guardrail note).

4 / 5

Workflow Clarity

A clear six-step sequence with an explicit STOP checkpoint (step 6), a status-verification step (step 4), and a guardrails checklist covering error recovery (invalid name → ask for a valid one; existing change → suggest continuing). It is not a 5 because there is no feedback loop after running 'openspec new change' — the skill does not say to verify the scaffold succeeded before proceeding to status.

4 / 5

Progressive Disclosure

This is a small, self-contained, single-purpose skill with no external bundle files and no references in the body, so everything belongs inline; sections (Input, Steps, Output, Guardrails) are well-organized and easy to navigate. There are no nested or buried references to penalize, satisfying the simple-skill exception despite the body being marginally over 50 lines.

5 / 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 natural trigger phrases. Its main limitation is that the 'what' side is thin — one action ('start a change using the artifact workflow') without conveying the workflow's concrete scope.

Suggestions

Add one or two concrete action phrases to the 'what' portion, e.g., 'Scaffolds the change directory, shows artifact status, and fetches instructions for the first artifact.'

Add a natural trigger variation such as 'new change' or 'start a change' to widen keyword coverage toward users already familiar with the OpenSpec workflow.

DimensionReasoningScore

Specificity

The description names the domain ("Start a new OpenSpec change") and one concrete action ("using the experimental artifact workflow"), but stops there — it doesn't enumerate what the workflow involves (scaffolding, artifact status, instructions), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is not a 4 because only a single action is stated, and not a 2 because the domain is named with a concrete action rather than generic processing.

3 / 5

Completeness

Both parts are present: what it does ("Start a new OpenSpec change using the experimental artifact workflow") and when to use it ("Use when the user wants to create a new feature, fix, or modification"). It is not a 5 because the 'what' is somewhat abstract — 'artifact workflow' is unexplained and the concrete scope (scaffolding only, no artifact creation) is not conveyed.

4 / 5

Trigger Term Quality

"create a new feature, fix, or modification" captures natural phrases users would say, giving good synonym coverage of the core intent. It is not a 5 because common variations like "new change", "add a feature", or the kebab-case naming convention users may mention are absent; it is above 3 because multiple natural synonyms (feature, fix, modification) are present rather than a single keyword.

4 / 5

Distinctiveness Conflict Risk

The "OpenSpec" brand term carves out a clear niche that other skills would not match, keeping conflict risk low. It is not a 5 because the trigger clause "create a new feature, fix, or modification" alone is broad and could compete with generic feature-implementation skills when the OpenSpec context is not salient.

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/openspec-flow

Path

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