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

86%

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 operational workflow: concrete commands, explicit validation with feedback loops around a destructive move, and unambiguous sequencing. The only notable weakness is repetition between the steps and the Guardrails section, plus slightly dense inline boilerplate that could be factored out.

DimensionReasoningScore

Conciseness

The body is dense procedural guidance with commands, routing rules, and failure paths, and it does not explain concepts Claude already knows. However, there is genuine repetition — the Guardrails section restates rules already stated in the steps (announce the change, run sync inline), and the context/operationGuidance handling contract in step 1 is expressed in several overlapping ways — which keeps it below the lean top anchor.

4 / 5

Actionability

Fully executable commands are given throughout — `openspec instructions archive --change "<name>" --json`, `openspec status --change "<name>" --json`, `mkdir -p "<planningHome.changesDir>/archive"`, `mv "<changeRoot>" ...` — along with the exact JSON fields to parse and explicit routing for each prompt answer. The guidance is copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints: artifact/task completion checks, a mandatory post-sync re-comparison of every capability, stop-on-failure rules ("If the sync failed, or any capability does not match, report what differs and stop — do not archive"), and a pre-move existence check for the destructive `mv`. Feedback loops and a guardrail checklist are both present, matching the top anchor.

5 / 5

Progressive Disclosure

No bundle files exist, so all content lives in a single SKILL.md with well-organized step, guardrail, and output-template sections — good structure overall. Minor gaps: ~170 lines of dense procedural text (e.g., the shared store-selection paragraph and instruction-contract rules) is inlined where a reference file could carry it, and the `openspec-sync-specs` workflow is invoked without a path or link to its location.

4 / 5

Total

18

/

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, third-person description with an explicit and well-formed "Use when..." trigger clause. Its main weaknesses are limited action specificity (only the top-level archive action is named) and the vague "experimental workflow" phrasing that slightly blurs which domain it belongs to.

Suggestions

Enumerate the key sub-actions in the description, e.g., "Checks artifact and task completion, syncs delta specs to main specs, and moves the completed change to the archive directory" to raise specificity.

Add one or two natural user phrasings as triggers, such as "move this change to the archive" or "wrap up this change", to broaden keyword coverage.

Replace or contextualize "experimental workflow" with the tool/domain name (e.g., "openspec change") so it is distinguishable from other workflow/archive skills.

DimensionReasoningScore

Specificity

"Archive a completed change in the experimental workflow" names the domain plus the actions "finalize" and "archive", but does not enumerate the concrete sub-actions the skill performs (completion checks, spec syncing, moving to the archive directory). It matches the anchor for naming a domain with 1-2 concrete actions rather than listing several specific actions.

3 / 5

Completeness

It explicitly answers both what ("Archive a completed change in the experimental workflow") and when ("Use when the user wants to finalize and archive a change after implementation is complete") with a concrete trigger phrase, matching the top anchor; the "when" clause is fully explicit rather than weakly implied.

5 / 5

Trigger Term Quality

Natural trigger terms are present — "archive", "finalized", "completed", "after implementation is complete" — which users would plausibly say. A few common variations (e.g., "move this change to the archive", "wrap up the change") are missing, so it fits good-but-not-comprehensive keyword coverage.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (archiving a completed change), but "experimental workflow" is opaque without naming the tool/domain, and closely related sibling skills (status, sync, list) create minor overlap risk. It is mostly distinct rather than having minimal conflict risk.

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