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.

64

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

Quality

Content

81%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, largely executable workflow with strong sequencing and genuine validation checkpoints (status checks, confirmation prompts, target-collision handling) before the destructive archive move. Weaknesses are minor: some redundancy between the Guardrails section and the steps, a somewhat high-level delta-spec comparison step, and no offloading of the sync-assessment detail despite the body's length.

DimensionReasoningScore

Conciseness

The body gives commands, paths, and decision rules directly with no explanations of concepts Claude already knows, e.g. 'Run `openspec status --change "<name>" --json`' and 'Count tasks marked with `- [ ]`'. It is not a 5 because the Guardrails section repeats steps 1, 4, and 6 ('Always prompt for change selection if not provided', 'Show clear summary of what happened'), and the opening line duplicates the description.

4 / 5

Actionability

Most steps are executable with copy-paste commands ('mkdir -p openspec/changes/archive', 'mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>') and a concrete Task-tool invocation including subagent_type and prompt template. It falls short of anchor 5 because step 4's 'Determine what changes would be applied' is high-level with no command or method for comparing delta specs to main specs.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints before the destructive move: parsing artifact status, counting incomplete tasks, checking 'If target already exists: If yes: Fail with error, suggest renaming existing archive or using different date', plus AskUserQuestion confirmation loops for incomplete artifacts/tasks. This matches anchor 5 (explicit validation, feedback loops for error recovery), and the destructive-operation cap does not apply since validation is present throughout.

5 / 5

Progressive Disclosure

The body is well organized into Steps, Output On Success, and Guardrails sections with no nested references and only a one-level reference to the openspec-sync-specs skill. Not a 5 because at roughly 93 body lines it exceeds the simple-skill (<50 line) allowance for a top score without external references, and the delta-spec sync assessment details could live in a reference file.

4 / 5

Total

17

/

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 solid description with an explicit 'Use when...' trigger clause and natural keywords, written in third person. Its main weakness is narrow action coverage — it describes only the archive/finalize outcome, not the completion checks and spec syncing the skill actually performs, and it omits the openspec tool name that would sharpen distinctiveness.

Suggestions

Enumerate the key actions in the description (check artifact/task completion, sync delta specs to main specs, move the change to a dated archive folder) to raise specificity from naming one action to several.

Add natural trigger variations such as 'archive this change', 'move the change to archive', or 'openspec archive' to broaden trigger term coverage.

Mention openspec explicitly in the 'when' clause so the skill is clearly distinguishable from generic archive or cleanup workflows.

DimensionReasoningScore

Specificity

The description names the domain ('completed change in the experimental workflow') and one to two concrete actions ('Archive', 'finalize'), but does not enumerate the skill's other concrete behaviors such as completion checks, delta-spec syncing, or the dated archive move. This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several listed actions.

3 / 5

Completeness

It 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') in third person. Not a 5 because the 'when' clause largely restates the 'what' instead of adding concrete trigger phrases or contexts.

4 / 5

Trigger Term Quality

'archive', 'finalize', and 'implementation is complete' are phrases a user would naturally say when needing this skill, giving good keyword coverage. It falls short of anchor 5 because common variations like 'move change to archive' or the tool name 'openspec' are absent.

4 / 5

Distinctiveness Conflict Risk

The 'experimental workflow' and 'change' terminology ties it to a specific openspec-style workflow, making it mostly distinct with only minor overlap risk against generic archive/cleanup skills. It lacks the explicit tool naming ('openspec') needed for a clear niche at anchor 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

dwmkerr/livedown

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.