CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-update-change

Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use when the user wants to revise a change's plan, fold new decisions into it, or reconcile its artifacts after an edit. Also use when the user says "openspec update change" or "opsx update". If the user means the openspec update CLI command, which refreshes generated files, run that command instead. Never edits code.

Quality

90%

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

88%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-engineered workflow skill: exact commands, explicit pre-write validation, feedback loops, and firm guardrails against writing code or advancing the build frontier. Its weaknesses are mild repetition of guardrail statements, a few tangled sentences, and edge-case material that lengthens the file without a quick-path summary.

Suggestions

Consolidate the repeated guardrails (never write to resolvedOutputPath, leave skipped artifacts untouched, confirm before writing) into the Guardrails section only, and reference them from steps 2, 4, and 6 instead of restating them.

Add a 2-3 line quick-path summary (e.g., status -> read artifacts -> propose revisions -> confirm -> write) at the top so the common case is scannable before the store-selection and root-null edge cases.

Split the dense store-selection and project-check paragraphs into short labeled bullets to reduce re-reading cost per invocation.

DimensionReasoningScore

Conciseness

Nearly every token carries non-obvious operational detail (store flag stickiness, "root": null semantics, existingOutputPaths vs resolvedOutputPath) with no padding or explanation of known concepts, matching anchor 4. Not 5: several guardrails are repeated across steps 2, 4, and the Guardrails section, and some sentences (e.g., the store-selection paragraph) are convoluted and could be tightened.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with exact syntax (openspec status --change "<name>" --json, openspec instructions "<artifact-id>" --change "<name>" --json, openspec list --json), concrete JSON fields to read (root, existingOutputPaths, lastModified), and specific path-creation checks. This is an instruction-only skill and its guidance is concretely actionable, so absence of code is not penalized.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints (project-root check before any write, re-refreshing status/instructions immediately before creating a glob file, confirm-before-write on every edit) and feedback loops for error recovery (stop on skipped artifacts, missing dependencies, or failed checks). Matches the anchor-5 pattern of validate-then-proceed with retry/stop guidance.

5 / 5

Progressive Disclosure

Single-file skill with no bundle files; content is appropriately placed for a CLI-driving workflow and organized under clear bolded sections (Store selection, Project check, Input, Steps, Output, Guardrails) with a one-line overview. Anchor 4 rather than 5: at ~100 lines, the interleaved edge-case handling (store selection, root-null disambiguation, the 5-item glob procedure) makes the main happy path harder to scan, a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

87%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 strong description that states concrete capabilities, gives explicit 'Use when' triggers including literal command phrases, and even disambiguates the nearest conflicting intent (the CLI refresh command). The only weakness is that its capability list expresses one core operation through several synonymous phrasings rather than a breadth of distinct actions.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ("revising its existing planning artifacts", "fold new decisions into it", "reconcile its artifacts after an edit", "Never edits code") with an explicit CLI-command redirect. Not 5 because the listed actions are near-synonymous variations on one capability rather than a comprehensive list of distinct operations; well above 3 since more than 1-2 concrete actions plus disambiguation are given.

4 / 5

Completeness

Explicitly answers both: what ("Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another") and when ("Use when the user wants to revise a change's plan... Also use when the user says 'openspec update change' or 'opsx update'") with concrete trigger phrases. This matches the anchor-5 example pattern exactly; a 'Use when...' clause is present, so no cap applies.

5 / 5

Trigger Term Quality

Good natural-term coverage: "revise a change's plan", "fold new decisions into it", "reconcile its artifacts", plus the literal phrases users would type ("openspec update change", "opsx update"). Not 5 because a few natural variants (e.g., "update the spec", "edit the design") are not covered.

4 / 5

Distinctiveness Conflict Risk

Clear niche (revising existing change artifacts, distinct from creating/applying/archiving changes) with distinct triggers, and it preempts its closest conflict explicitly: "If the user means the openspec update CLI command, which refreshes generated files, run that command instead." Third-person voice throughout, so no voice penalty.

5 / 5

Total

18

/

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

finos/morphir-dotnet

Path

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