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.

67

Quality

80%

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

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, actionable multi-step workflow with strong validation checkpoints and executable commands. Its main weakness is mild redundancy between the numbered steps and the Guardrails section.

Suggestions

Trim the Guardrails section to rules not already stated in the numbered steps (e.g. drop 'Always prompt for change selection' and 'Use artifact graph for completion checking' which restate steps 1-2), keeping only net-new guardrails.

DimensionReasoningScore

Conciseness

The body is mostly lean and free of concept-explanation padding, but the 'Guardrails' section restates rules already expressed in the numbered steps (e.g. prompt-for-selection, use of the status artifact graph), adding redundancy rather than new value, matching the 'mostly efficient but could be tightened' anchor.

2 / 3

Actionability

It provides concrete, executable commands throughout — `openspec list --json`, `openspec status --change "<name>" --json`, `mkdir -p openspec/changes/archive`, and the `mv` invocation — plus concrete tool guidance (AskUserQuestion), matching the fully-executable anchor.

3 / 3

Workflow Clarity

The six steps are clearly sequenced with explicit validation checkpoints (artifact completion, task completion) and confirm-before-proceed feedback loops for a destructive move operation, matching the clear-sequence-with-validation anchor.

3 / 3

Progressive Disclosure

No bundle files exist and none are needed; the single self-contained file is organized into well-labeled sections (Input, Steps, Output, Guardrails) with a clearly signaled cross-reference to the openspec-sync-specs skill, satisfying the well-organized single-file case for progressive disclosure.

3 / 3

Total

11

/

12

Passed

Description

75%

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 states what the skill does and when to use it with an explicit trigger, scoring well on completeness and distinctiveness. It is slightly limited on specificity (one action) and trigger coverage (jargon-heavy).

Suggestions

Broaden the action list beyond a single 'archive' verb to mention the supporting steps surfaced in the body (e.g. checking completion, syncing specs) to lift specificity.

Add more natural user-facing trigger phrasing alongside 'finalize and archive' (e.g. 'close out', 'ship', 'mark a change done') and de-emphasize internal jargon like 'experimental workflow'.

DimensionReasoningScore

Specificity

It names the domain ('experimental workflow') and a concrete action ('Archive a completed change') but lists only a single action rather than multiple specific concrete actions, so it sits at the 'names domain and some actions' anchor rather than the level-3 multi-action examples.

2 / 3

Completeness

It explicitly answers both 'what' ('Archive a completed change in the experimental workflow') and 'when' via an explicit 'Use when...' clause, matching the level-3 anchor for clearly answering both with an explicit trigger.

3 / 3

Trigger Term Quality

Phrases like 'finalize and archive a change' are reasonably natural, but 'experimental workflow' is internal jargon and common user variations (e.g. 'done', 'ship', 'close out') are missing, matching the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

The niche is narrow and specific — archiving a completed change in the openspec experimental workflow — with distinct triggers unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

10

/

12

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.

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