CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

62

Quality

72%

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 ./.agent/skills/openspec-archive-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-structured, lean instruction-only skill with concrete CLI commands, explicit user-confirmation checkpoints around a destructive move, and a clear output template. The gaps are small: a couple of high-level directives without a method, no post-archive verification, and mild duplication between the steps and the Guardrails section.

Suggestions

Add a post-move verification step (e.g. confirm openspec/changes/archive/YYYY-MM-DD-<name> exists and openspec/changes/<name> is gone) with a recovery path, which would lift workflow_clarity to 5.

Specify how to compare delta specs with main specs (e.g. which sections to diff or an example) so step 4 is as executable as the rest.

Trim the Guardrails bullets that restate step instructions and keep only the ones adding new information (e.g. the .openspec.yaml preservation note).

DimensionReasoningScore

Conciseness

The body gives commands and paths directly ("openspec list --json", "mkdir -p openspec/changes/archive") with no explanation of concepts Claude already knows; the only trimmable material is the Guardrails section restating rules already in the steps ("Always prompt for change selection if not provided"), which is minor duplication fitting the efficient-with-minor-trims anchor at 4 rather than the noticeable-verbosity anchor at 3.

4 / 5

Actionability

Concrete executable commands with literal paths ("openspec status --change \"<name>\" --json", "mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>"), explicit task-marking syntax ("- [ ]" vs "- [x]"), and a copy-paste output template cover the common cases; a few directives stay high-level ("Compare each delta spec with its corresponding main spec" gives no comparison method), keeping it below fully-executable at 5.

4 / 5

Workflow Clarity

Six clearly numbered steps with explicit confirmation checkpoints (AskUserQuestion for selection, for incomplete artifacts, for incomplete tasks, and a three-option sync prompt) plus a target-exists failure check give this destructive move operation most of its checkpoints; it falls short of 5 because there is no post-move verification that the archive succeeded and no error-recovery loop for the mv step.

4 / 5

Progressive Disclosure

The file is cleanly sectioned (Input / Steps / Output On Success / Guardrails) and correctly delegates sync detail to the openspec-sync-specs skill, a clearly signaled one-level reference; no bundle files exist and nothing clearly needs splitting, but at ~105 lines with some step-level detail that could live elsewhere it fits 'good structure; minor organization gaps' at 4 rather than the well-split anchor at 5.

4 / 5

Total

16

/

20

Passed

Description

70%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, correctly structured description with an explicit 'Use when' clause and natural trigger terms. Its main weakness is a thin 'what' — it names only the single archive action while the skill also performs completion checks, task verification, and optional spec syncing.

Suggestions

Enumerate the sub-capabilities in the what-clause, e.g. 'Archive a completed change: check artifact and task completion, assess delta-spec sync, then move the change to the archive' — this would lift specificity from 3 toward 4-5.

Add one or two natural trigger variations such as 'close out', 'wrap up', or 'mark a change done' to broaden trigger-term coverage.

Mention the date-stamped archive destination (openspec/changes/archive/YYYY-MM-DD-<name>) to sharpen distinctiveness from sibling openspec skills.

DimensionReasoningScore

Specificity

"Archive a completed change" names the domain plus one concrete action, but the description never mentions the completion checks, task verification, or spec syncing the skill actually performs, matching the '1-2 concrete actions, but not comprehensive' anchor rather than the several-action anchor at 4.

3 / 5

Completeness

Both parts are explicitly present: the what ("Archive a completed change in the experimental workflow") and a clear when-clause ("Use when the user wants to finalize and archive a change after implementation is complete"), so it sits above the missing-when anchor at 3 but below 5 because the what is thin and the when largely restates it rather than adding distinct trigger phrases.

4 / 5

Trigger Term Quality

Natural user phrases like "archive", "finalize", "change", and "after implementation is complete" are present and would be said verbatim by a user; a few common variations (e.g. "close out" or "wrap up the change") are missing, fitting the 'good keyword coverage; a few natural terms missing' anchor rather than 3 where relevant keywords are only partially covered.

4 / 5

Distinctiveness Conflict Risk

Scoped to "the experimental workflow" with archive-specific triggers, it is mostly distinct from generic skills; shared vocabulary with sibling openspec skills (e.g. sync or list) creates minor overlap risk, matching 'mostly distinct; minor overlap risk' rather than the clear-niche anchor at 5.

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
Draculabo/AntigravityManager
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.