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.

Quality

88%

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

92%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 workflow skill: concrete executable commands, an explicit stop-and-wait checkpoint, and guardrails covering naming errors and duplicate changes. The only trimmable redundancy is the thrice-stated --schema handling.

DimensionReasoningScore

Conciseness

The body is imperative and lean with zero concept-explanation padding, but schema handling ('--schema') is stated three times (step 2, the note in step 3, and a guardrail bullet). Minor instances of over-explanation that could be trimmed, matching anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands ('openspec new change "<name>"', 'openspec status --change "<name>"', 'openspec instructions <first-artifact-id> --change "<name>"'), a named interaction tool (AskUserQuestion), and a concrete kebab-case derivation example. Matches anchor 5: specific commands cover the common cases.

5 / 5

Workflow Clarity

A clear numbered 1-6 sequence with an explicit STOP checkpoint (step 6), a status-driven decision point ('find the first artifact with status "ready"'), and error-recovery guardrails (invalid name -> ask for a valid one; existing change -> suggest continuing). No destructive or batch operations, so the feedback-loop cap does not apply; checkpoints and recovery guidance are explicit, matching anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed: every section (Input, Steps, Output, Guardrails) is essential workflow instruction that belongs in SKILL.md, with nothing inlined that should be split out and trivially easy navigation. Per the simple-skill guidance this self-contained, well-sectioned structure matches anchor 5; not 4 because there are no organization gaps to point to.

5 / 5

Total

19

/

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 solid description that clearly and explicitly states both what the skill does and when to use it, anchored to a distinctive niche (OpenSpec). Its main weakness is specificity — it describes only the top-level action rather than the concrete operations the workflow performs, and it lacks some natural trigger synonyms.

Suggestions

Enumerate 2-3 concrete actions in the description (e.g., 'Scaffolds the change directory, shows artifact status and dependencies, and fetches instructions for the first artifact') to lift specificity from one generic action to a concrete list.

Add natural trigger synonyms users would actually say, such as 'propose a change', 'start a change', 'spec-driven change', or 'openspec change', to improve trigger coverage.

Narrow the when-clause to the OpenSpec context (e.g., 'Use when the user wants to create a new OpenSpec change, feature, or fix') to reduce overlap with generic feature-implementation skills.

DimensionReasoningScore

Specificity

Names the concrete domain ('OpenSpec change', 'experimental artifact workflow') and one action ('Start a new change'), but does not enumerate the specific operations it performs (scaffolding the change directory, showing artifact status, fetching first-artifact instructions). Fits anchor 3: domain plus 1-2 concrete actions, not comprehensive.

3 / 5

Completeness

Explicitly answers both: 'Start a new OpenSpec change using the experimental artifact workflow' (what) and 'Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach' (when, with concrete trigger phrases). Matches anchor 5; the when-clause is already explicit, so anchor 4's 'could be more explicit' does not fit.

5 / 5

Trigger Term Quality

Includes natural user phrasings ('create a new feature, fix, or modification'), but misses common synonyms users would say such as 'propose a change', 'spec', 'scaffold', or 'workflow'. Good keyword coverage with a few natural terms missing, matching anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'OpenSpec' is a distinct niche, but the broad when-clause ('create a new feature, fix, or modification') could fire on general feature-implementation requests where OpenSpec is not intended. Mostly distinct with minor overlap risk, matching anchor 4; not 5 due to that overlap, not 3 because the named tool anchors it clearly.

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

PBH-BTN/PeerBanHelper

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.