CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-archive-change

Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says "openspec archive" or "opsx archive".

Quality

81%

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

The canonical home for this skill is openspec-archive-change in Fission-AI/OpenSpec

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 disciplined, high-clarity CLI workflow: commands are concrete, the sequence is explicit, and destructive operations are guarded with validation and recovery paths. The weaknesses are redundancy (the Guardrails section repeats in-step rules) and a monolithic single-file structure with an unbundled external workflow dependency at its center.

Suggestions

Trim the Guardrails section to rules not already stated in the steps — several entries ('Never archive while a spec sync is still in flight', 'If sync is requested, run the openspec-sync-specs workflow inline') duplicate step 4 verbatim, which costs tokens without adding safety.

Move the detailed post-sync structural contract in step 4 (title, Purpose, requirement/scenario heading rules) into a bundled reference file and link it one level deep, keeping only the verification checklist inline.

Give the 'openspec-sync-specs' workflow a concrete path or bundle reference so the delegated sync step is executable from this skill's own files rather than assumed to exist.

DimensionReasoningScore

Conciseness

The body mostly earns its tokens with non-obvious CLI contracts, but is noticeably tightenable: the Guardrails section restates rules already given in the steps ('Never archive while a spec sync is still in flight', 'If sync is requested, run the openspec-sync-specs workflow inline', 'Apply relevant runtime context and report conflicts'), and the store-selection and context/guidance paragraphs are convoluted. Matches anchor 3 ('mostly efficient but... could be tightened') rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is largely executable: exact commands ('openspec instructions archive --change "<name>" --json', 'openspec status --change "<name>" --json', 'mkdir -p "<planningHome.changesDir>/archive"', 'mv "<changeRoot>" ...'), named JSON fields to parse, and a precise date-prefix rule. The minor gap is that the core sync step delegates to an 'openspec-sync-specs' workflow that is not bundled or pathed, so that portion cannot be executed from this file alone — anchor 4, not 5.

4 / 5

Workflow Clarity

Six clearly numbered steps with explicit validation checkpoints and feedback loops around destructive operations: artifact-status and task-count checks with user confirmation, strict post-sync structural verification with stop conditions, an existence check before the 'mv', and error-recovery guidance ('report what differs and stop — do not archive. Nothing has moved... the user can fix the mismatch or re-run the sync'). This matches anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all content lives inline in one ~210-line file. Sections are clearly marked (Steps, Output On Success, Guardrails), but content that could plausibly be split out (the sync structural contract, store-selection rules, project-check branching) is inlined, and the external 'openspec-sync-specs' workflow reference has no path. Anchor 3: 'some structure but could be better organized' — not 4 because the split-out opportunity is more than minor.

3 / 5

Total

15

/

20

Passed

Description

82%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: explicit what and when, with literal command triggers that map directly to user utterances. Its main weakness is specificity — it names only the archive action and misses the verification and spec-sync steps the workflow actually performs, slightly understating the skill's scope.

DimensionReasoningScore

Specificity

The description names the domain ('OpenSpec change in the experimental workflow') and one concrete action ('Archive a completed OpenSpec change'), but omits other capabilities the skill performs such as artifact/task verification and delta-spec sync assessment. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — not 4, since several concrete actions are missing from the description.

3 / 5

Completeness

It explicitly answers both what ('Archive a completed OpenSpec change in the experimental workflow') and when with concrete trigger phrases ('Use when the user wants to finalize and archive a change after implementation is complete. Also use when the user says...'). This is the anchor-5 pattern; not 4 because the 'when' is fully explicit with multiple concrete triggers.

5 / 5

Trigger Term Quality

It includes literal user-utterable phrases ("openspec archive", "opsx archive") and natural conditions ('finalize and archive a change after implementation is complete'). Good coverage but missing common synonyms users might say (e.g., 'close out a change', 'complete a change'), so it falls between anchor 4 and 5, closer to 4.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (archiving completed OpenSpec changes) with distinct literal command triggers ('openspec archive', 'opsx archive') that would not fire for sibling OpenSpec skills (sync, status, new change). Minimal conflict risk — matches anchor 5.

5 / 5

Total

17

/

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

.claude/skills/openspec-archive-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.