CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-archive-change

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.zcode/skills/openspec-archive-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

The body delivers a well-sequenced, thoroughly validated archive workflow with concrete commands, explicit user-prompt routing, and strong safeguards around the destructive move operation. Its main costs are repetition in the instructions/guard-rules sections and prose-only handling of the spec-sync step, plus dense inline contract text that could live in a reference file.

Suggestions

Deduplicate the instructions-contract rules: state them once in step 1 (or a short 'Runtime inputs' section) and reduce the Guardrails list to items not already covered, which would tighten conciseness without losing behavior.

Move the ~26-line instructions-archive handling contract (context vs operationGuidance semantics) into a one-level-deep reference file and keep a 3-4 line summary inline, improving progressive disclosure and token efficiency.

Make the step 4 sync invocation more concrete: show the exact command or delegation wording used to run the 'openspec-sync-specs' workflow inline, and specify the comparison output format for the combined summary shown before prompting.

DimensionReasoningScore

Conciseness

The body is dense operational guidance with no explanation of concepts Claude already knows, but the instructions-archive contract (lines 35-60) is repetitive — the 'never copy verbatim' / 'prompt-level contracts, not enforceable checks' rules are restated in the section, again mid-step, and again in Guardrails — and the store-selection paragraph explains the same flag rule twice. This fits anchor 3, 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not anchor 4 because the repetition is more than minor.

3 / 5

Actionability

Concrete, executable commands appear throughout ('openspec status --change "<name>" --json', 'openspec list --json', 'mkdir -p "<planningHome.changesDir>/archive"', 'mv "<changeRoot>" ...') alongside explicit prompt options and answer routing. It stops short of anchor 5 because the delta-spec comparison and the inline 'openspec-sync-specs' workflow invocation are described in prose rather than as runnable commands or a referenced, complete procedure.

4 / 5

Workflow Clarity

The six steps are clearly sequenced with explicit validation checkpoints (artifact status check, task-count check, mandatory post-sync re-verification of every capability against the delta, 'report what differs and stop — do not archive') and error-recovery loops for the destructive mv of changeRoot. The destructive-operation validation cap is satisfied, and this matches anchor 5's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

No bundle files exist and none are strictly needed for this workflow; the body is well-sectioned (Store selection, Input, numbered Steps, Output template, Guardrails) and easy to navigate. It is anchor 4 rather than 5 because the ~26-line instructions-archive behavioral contract and the dense store-selection paragraph are inline material that could be split into a one-level-deep reference file to slim the always-loaded overview.

4 / 5

Total

16

/

20

Passed

Description

71%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.

The description cleanly and explicitly answers both what the skill does and when to use it, with a concrete trigger clause and third-person voice. Its weaknesses are thin action coverage (only 'archive' is named despite the multi-part workflow) and limited natural-synonym coverage in trigger terms.

Suggestions

Enumerate the concrete actions performed, e.g. 'Checks artifact and task completion, syncs delta specs to main specs, then moves the change to the archive directory' — this would raise specificity from naming a single action to several.

Add natural trigger variations users might say, such as 'done with a change', 'finished implementing', or 'move the change to the archive', to improve trigger-term coverage.

Consider naming the tool context (OpenSpec) in the description so it is distinguishable from generic archive or file-cleanup skills at a glance.

DimensionReasoningScore

Specificity

The description names the domain ('completed change in the experimental workflow') and one concrete action ('Archive'), roughly matching anchor 3's 'names domain and 1-2 concrete actions'. It does not list the several sub-actions the body performs (completion checks, spec sync, moving the change), so it falls short of anchor 4 while being more concrete than anchor 2's generic minimal action.

3 / 5

Completeness

It explicitly answers both parts: 'Archive a completed change in the experimental workflow' states what, and 'Use when the user wants to finalize and archive a change after implementation is complete' gives a concrete, explicit when-clause that is stronger than anchor 4's example, matching anchor 5.

5 / 5

Trigger Term Quality

Relevant keywords are present ('archive', 'finalize', 'completed change', 'implementation is complete') but common variations a user might naturally say ('done', 'finished', 'wrap up', 'move to archive') are missing, fitting anchor 3 rather than anchor 4's 'a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

Scoping to 'the experimental workflow' and 'change' gives it a clear niche with distinct triggers, though the overloaded word 'archive' leaves minor overlap risk with generic file-archiving skills — anchor 4, not anchor 5's 'minimal conflict risk'.

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

partme-ai/full-stack-skills

Path

.zcode/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.