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.

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 highly actionable, well-sequenced CLI-driven workflow with exact commands, response fields, and clear branching per status. The only weaknesses are mild repetition between the steps and guardrails and the absence of an error-recovery loop.

DimensionReasoningScore

Conciseness

The body is command-first and free of explanations Claude already knows, with tight bullets and exact JSON field names. Minor duplication could be trimmed: the 'do NOT include context/rules in output' rule appears in Step 3 and again in Guardrails, and 'STOP after creating ONE artifact' repeats the one-artifact guardrail.

4 / 5

Actionability

Three copy-paste-ready CLI commands with exact flags ('openspec list --json', 'openspec status --change "<name>" --json', 'openspec instructions <artifact-id> --change "<name>" --json'), exact response fields to parse, and explicit per-status branching cover the common cases, matching the fully-executable anchor.

5 / 5

Workflow Clarity

A clear four-step sequence with explicit branches (complete / ready / all blocked) and a verification guardrail ('Verify the artifact file exists after writing before marking progress'). It lacks a validate-fix-retry feedback loop — the 'all blocked' branch only says to 'suggest checking for issues' — so it stops short of the level-5 anchor; the single-artifact, non-destructive nature means no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist and none are referenced; the body is well-sectioned (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no inlined reference material and no nested references. Schema-specific detail is delegated to the CLI at runtime, which is an appropriate progressive-disclosure mechanism.

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 well-formed description with an explicit 'Use when...' clause, third-person voice, and a clearly scoped domain. Its main limitation is thin action specificity and a when-clause that mostly restates the what instead of adding distinct trigger terms.

Suggestions

Enumerate 2-3 concrete actions in the what-clause (e.g., 'create the next artifact — proposal, spec, design, or tasks — based on the change's workflow status') to lift specificity.

Add distinct trigger variations users might actually say, such as 'next step', 'keep going on the change', or artifact names, to broaden trigger coverage beyond restatements of the what.

Tighten 'or continue their workflow' to reference the OpenSpec change specifically to reduce overlap with generic workflow-continuation requests.

DimensionReasoningScore

Specificity

The description names the domain ('an OpenSpec change') and one concrete action ('creating the next artifact'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not enumerate several specific actions (e.g., proposal, specs, design, tasks), which the level-4 anchor requires.

3 / 5

Completeness

Both 'what' ('Continue working on an OpenSpec change by creating the next artifact') and 'when' ('Use when the user wants to progress their change, create the next artifact, or continue their workflow') are explicitly present. The when-clause largely restates the what rather than adding distinct trigger contexts, so it does not clearly meet the level-5 anchor's fully concrete trigger phrases.

4 / 5

Trigger Term Quality

'progress their change', 'create the next artifact', and 'continue their workflow' are natural phrases a user would say, giving good keyword coverage. Common variations and synonyms ('next step', 'keep going', artifact names like proposal or tasks) are missing, so it falls short of the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

'OpenSpec change' and 'artifact' establish a clear niche with mostly distinct triggers. The generic phrase 'or continue their workflow' and potential sibling openspec skills create minor overlap risk, matching the 'mostly distinct' level-4 anchor rather than the minimal-risk level-5 anchor.

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

TencentBlueKing/bk-bcs

Path

bcs-runtime/bcs-k8s/bcs-component/bcs-drplan-controller/.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.