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.

65

Quality

82%

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

86%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-crafted, self-contained instruction skill: concrete executable commands for every step, a clearly sequenced workflow with explicit stopping points and useful guardrails, and no padding. The only refinements would be trimming minor redundancy and adding light handling for command failures.

DimensionReasoningScore

Conciseness

The body is efficient: concrete commands, no explanations of concepts Claude already knows, and tight sections. A few tokens could be trimmed — the '**IMPORTANT**: Do NOT proceed without understanding' note restates step 1, and the '--schema' guardrail repeats steps 2-3 — so it falls just short of the lean anchor 5 while being well above anchor 3.

4 / 5

Actionability

Fully executable copy-paste commands are given for every step ('openspec new change "<name>"', 'openspec status --change "<name>"', 'openspec instructions <first-artifact-id> --change "<name>"', 'openspec schemas --json'), along with a concrete name-derivation example ('add user authentication' → 'add-user-auth') and a verbatim question for the AskUserQuestion tool. This matches the anchor for copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

A clear numbered 1-6 sequence with an explicit STOP step and guardrail feedback loops for error recovery (invalid kebab-case name → ask for a valid one; existing change → suggest continuing). It falls short of anchor 5 because there is no validation of command output or handling of command failure (e.g., what to do if 'openspec new change' errors), though the operation is non-destructive so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

This is a simple, self-contained skill (~45 content lines) with no need for external reference files, and none are bundled. Content is well organized into Input, Steps, Output, and Guardrails sections with nothing that belongs in a separate file, which per the rubric's simple-skill provision merits a 5.

5 / 5

Total

18

/

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 third-person voice, an explicit 'Use when...' clause, and a distinct niche. Its main weakness is that the trigger clause is not gated on OpenSpec context, so it could fire for generic feature requests, and it undersells the concrete actions the skill performs.

Suggestions

Gate the when-clause on OpenSpec context, e.g., 'Use when the user wants to start or scaffold a new OpenSpec change, or mentions OpenSpec workflows', to reduce false triggers on generic feature requests.

List more of the skill's concrete actions in the description (e.g., scaffolds the change directory, shows artifact status, fetches instructions for the first artifact) to raise specificity from one action to several.

Add common synonyms such as 'change request', 'spec', or 'proposal' to broaden natural trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('OpenSpec change') and one concrete action ('Start a new OpenSpec change using the experimental artifact workflow'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list the several specific actions the skill performs (scaffolding, status, instructions), so it is below anchor 4, but it is more concrete than the domain-only anchor 2.

3 / 5

Completeness

Both 'what' ('Start a new OpenSpec change using the experimental artifact workflow') and an explicit 'when' ('Use when the user wants to create a new feature, fix, or modification...') are present. The when-clause could be more specific — it does not mention OpenSpec context as a trigger, so it is broader than the skill itself — keeping it below anchor 5 but well above anchor 3's missing/weak 'when'.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ('create a new feature', 'fix', 'modification', 'structured step-by-step approach'), giving good keyword coverage. A few natural terms are missing (e.g., 'change request', 'spec', 'proposal'), so it falls short of the comprehensive synonym coverage of anchor 5 but is clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

'OpenSpec change' and 'experimental artifact workflow' establish a clear niche with minimal conflict risk among similar skills. However, the when-clause ('create a new feature, fix, or modification') would naturally fire for ordinary feature requests unrelated to OpenSpec, a minor overlap risk that keeps it below 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/git-workforest

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.