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

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 highly actionable, well-sequenced workflow with real validation checkpoints before the destructive archive move and a clear success-output template. Its only deductions are minor redundancy in the Guardrails section and the under-specified delta-spec comparison step.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (no concept explanations), but the Guardrails section partially restates earlier steps (e.g. 'Always prompt for change selection if not provided' duplicates Step 1's IMPORTANT note; 'Show clear summary of what happened' duplicates Step 6). Not 5: these repetitions could be trimmed.

4 / 5

Actionability

Concrete, copy-paste-ready commands throughout ('openspec list --json', 'openspec status --change "<name>" --json', 'mkdir -p openspec/changes/archive', 'mv openspec/changes/<name> ...'), exact JSON fields to parse, exact paths, and ready-made prompt option strings. Not 5: Step 4's 'Compare each delta spec with its corresponding main spec... Determine what changes would be applied' offers no concrete comparison method and defers entirely to another skill.

4 / 5

Workflow Clarity

A clearly sequenced six-step process with explicit validation checkpoints before the destructive move (artifact status check, task count check, delta-sync assessment, target-exists check with fail-and-suggest behavior) and confirmation loops via AskUserQuestion. The destructive-operation cap does not apply because validation steps are present.

5 / 5

Progressive Disclosure

A single well-sectioned file (Input / Steps / Output On Success / Guardrails) with no bundle files to organize; the one external dependency (the openspec-sync-specs skill) is clearly signaled and one level deep. Not 5: the body inlines the full instruction set with no reference structure, which is acceptable here but leaves nothing rewarded at the top anchor.

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' clause and a distinct niche, but it names only the single top-level action and its trigger phrasing mirrors the capability statement rather than adding varied natural trigger terms.

Suggestions

Enumerate the concrete actions the skill performs, e.g. 'Archive a completed change: check artifact and task completion, sync delta specs, and move the change to the archive directory.'

Add natural trigger variations to the 'when' clause, such as 'when the change is done, finished, or ready to be wrapped up'.

Clarify the domain beyond 'the experimental workflow' (e.g. mention openspec changes) to sharpen distinctiveness from sibling workflow skills.

DimensionReasoningScore

Specificity

Names the domain ('Archive a completed change in the experimental workflow') and a single core action, but does not enumerate the several concrete operations the skill actually performs (listing changes, checking artifact/task status, syncing specs, moving to archive). Not 4: only one action is stated, leaving coverage non-comprehensive.

3 / 5

Completeness

Both a clear 'what' (archive a completed change) and an explicit 'when' ('Use when the user wants to finalize and archive a change after implementation is complete') are present. Not 5: the 'when' clause largely restates the 'what' rather than adding distinct concrete trigger phrases.

4 / 5

Trigger Term Quality

Explicit 'Use when the user wants to finalize and archive a change after implementation is complete' supplies natural terms (archive, finalize, implementation is complete). Not 5: missing common variations users would say, e.g. 'done with a change' or 'wrap up the change'.

4 / 5

Distinctiveness Conflict Risk

Scoped to archiving changes in the experimental workflow, with triggers specific to finalization after implementation. Not 5: minor overlap risk with sibling openspec workflow skills (e.g. sync or complete-change skills) sharing terms like 'change' and 'spec'.

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

PBH-BTN/PeerBanHelper

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.