CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-apply-change

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

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

81%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 workflow with executable CLI commands, explicit state and error handling, and useful output templates. Its main weakness is redundancy: the context/operationGuidance rules are stated twice (step 3 and Guardrails), and the full output templates inflate the body beyond a lean overview.

Suggestions

Deduplicate the context/operationGuidance rules: keep one canonical statement (either step 3 or the Guardrails) and reference it from the other location.

Collapse the three full output templates into one representative example with a note on the variations, cutting roughly 40 lines.

Tighten the store-selection paragraph by stating the sticky --store rule once instead of re-explaining the flag on each unscoped example.

DimensionReasoningScore

Conciseness

The body is mostly operational with no basic-concept padding, but the context/operationGuidance contract in step 3 ("Read and consider it... They are not evidence of task completion...") and the Guardrails section restate the same rules nearly verbatim ("Do not use context or operation guidance as proof that a task is complete", "Do not copy runtime context or operation guidance into implementation files"). Not 2 because there is no explanation of known concepts and most directives are lean; not 4 because the duplication exceeds minor trimming.

3 / 5

Actionability

Fully executable, copy-paste-ready commands with exact flags ("openspec status --change \"<name>\" --json", "openspec instructions apply --change \"<name>\" --json", "openspec list --json", "openspec store list --json"), exact edit syntax ("- [ ]\u2192 - [x]"), explicit state handling (blocked/all_done), and concrete output templates. Not 4 because the commands and examples cover the common paths (named change, inferred, ambiguous, blocked, all done); "Make the code changes required" is appropriately task-defined rather than vague.

5 / 5

Workflow Clarity

A clear 7-step sequence with upfront state validation (parse status JSON, handle blocked/all_done before acting), explicit feedback loops for error recovery (pause on unclear task, design issues, errors; report and wait), loop-until-done semantics, a guardrail checklist, and end-of-session status reporting. Not 4 because checkpoints are present at entry, per-task, and exit; the workflow's state checks and pause conditions serve as the validation for its batch task loop.

5 / 5

Progressive Disclosure

Well-organized single-file body with clear headers (Store selection, Input, Steps, Output During/On Completion/On Pause, Guardrails, Fluid Workflow Integration) and no buried or nested references; no bundle files exist, and nothing strictly requires one. Not 5 because at ~170 lines with three full output templates plus a store-selection mechanics paragraph, it exceeds a lean overview and parts (output templates, store rules) could be consolidated or split out.

4 / 5

Total

17

/

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 concise, well-formed description that explicitly covers both what the skill does and when to use it, with natural trigger phrasing. Its main gaps are limited action specificity and a trigger clause that does not itself mention the OpenSpec domain, leaving slight overlap risk with generic task-implementation requests.

Suggestions

Add 1-2 more concrete actions to the what-clause, e.g., "Read the change's proposal/specs/tasks artifacts, implement the code changes, and check off completed tasks".

Include "OpenSpec" in the when-clause (e.g., "Use when the user wants to start implementing, continue, or work through tasks in an OpenSpec change") to reduce conflict with generic task-management skills.

DimensionReasoningScore

Specificity

"Implement tasks from an OpenSpec change" names the domain and one concrete action, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is below 4 because it does not enumerate several specific actions (e.g., reading proposal/specs/tasks artifacts, editing code, checking off tasks), and above 2 because the action is concrete and domain-anchored rather than generic.

3 / 5

Completeness

It explicitly answers both what ("Implement tasks from an OpenSpec change") and when ("Use when the user wants to start implementing, continue implementation, or work through tasks") with concrete trigger phrases, matching the top anchor. Not 4, because the when-clause is explicit and specific rather than weakly implied.

5 / 5

Trigger Term Quality

"start implementing, continue implementation, or work through tasks" are natural phrases a user would say, giving good keyword coverage. It falls short of 5 because common synonyms are missing, such as "apply the change", "do the tasks", or "work on the change".

4 / 5

Distinctiveness Conflict Risk

"OpenSpec change" carves a clear niche with minimal conflict risk against unrelated skills. Not 5, because the trigger clause omits "OpenSpec", so generic requests like "work through tasks" or "continue implementation" could loosely match non-OpenSpec task skills; not 3, because the domain term keeps overlap minor.

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

partme-ai/full-stack-skills

Path

.agents/skills/openspec-apply-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.