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

79%

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 ./bcs-runtime/bcs-k8s/bcs-component/bcs-drplan-controller/.claude/skills/openspec-archive-change/SKILL.md

The canonical home for this skill is openspec-archive-change in dwmkerr/git-workforest

SKILL.md
Quality
Evals
Security

Quality

Content

78%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, actionable procedural skill: concrete CLI commands, explicit user-confirmation checkpoints, defined failure handling for the archive-collision case, and proper delegation of sync logic. Remaining weaknesses are minor — a redundant guardrails section, an underspecified delta-spec comparison method, and no post-move verification.

Suggestions

Trim the Guardrails section to only non-duplicative rules (e.g. 'Preserve .openspec.yaml' and 'Don't block archive on warnings') since several bullets restate step 1 and step 4 verbatim.

Give step 4 a concrete comparison method — e.g. a command or explicit diff procedure for matching delta specs against 'openspec/specs/<capability>/spec.md' — so the sync assessment is executable rather than descriptive.

Add a post-archive verification step (confirm the moved directory exists at 'openspec/changes/archive/YYYY-MM-DD-<name>' and the source is gone) and specify behavior if a requested sync fails before proceeding to archive.

DimensionReasoningScore

Conciseness

The body is a lean procedural document with concrete commands and no explanation of concepts Claude already knows. Not a 5 because the Guardrails section restate content already specified in steps (e.g. 'Always prompt for change selection if not provided' repeats step 1's IMPORTANT note; 'If delta specs exist, always run the sync assessment...' repeats step 4); not a 3-adjacent lower score because the redundancy is minor and the rest is efficient.

4 / 5

Actionability

Mostly executable guidance: concrete commands ('openspec list --json', 'openspec status --change "<name>" --json', 'mkdir -p openspec/changes/archive', 'mv openspec/changes/<name> ...'), concrete paths, parsed JSON fields, and a copy-paste output template. Not a 5 because step 4's delta-spec comparison ('Compare each delta spec with its corresponding main spec... Determine what changes would be applied') is high-level direction with no concrete comparison method or command.

4 / 5

Workflow Clarity

A clear 6-step sequence with explicit validation checkpoints: artifact status check, task-file check, user confirmations via AskUserQuestion, and a pre-move existence check with defined failure handling ('Fail with error, suggest renaming'). Not a 5 because there are minor gaps — no verification that the 'mv' succeeded, and the archive proceeds regardless of whether the delegated sync actually succeeded.

4 / 5

Progressive Disclosure

A single self-contained skill file, clearly sectioned (Input, Steps, Output On Success, Guardrails) with easy navigation and no inlined content that belongs in a separate file. Sync execution is properly delegated to the openspec-sync-specs skill — a well-signaled one-level-deep reference — and no bundle files exist to score against, so nothing is buried or nested.

5 / 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, third-person voice, and natural trigger terms. Its main weakness is underselling the skill's actual capabilities — only the archive action is named, while completion checking and delta-spec syncing are unmentioned.

Suggestions

Broaden the 'what' to name the other concrete actions the skill performs, e.g. 'Check artifact and task completion, assess delta-spec sync state, then archive the completed change directory with a date-prefixed name.'

Add trigger variations and domain context to the 'when' clause, e.g. 'Use when the user wants to archive, finalize, or close out a completed openspec change.'

DimensionReasoningScore

Specificity

The description names the domain ('completed change in the experimental workflow') and one concrete action ('Archive'), matching the anchor 'names domain and 1-2 concrete actions, but not comprehensive' — it omits the skill's other capabilities like completion checking, delta-spec sync assessment, and summary reporting. Not a 2 because 'archive a completed change' is a concrete action rather than generic filler; not a 4 because only one action is listed.

3 / 5

Completeness

Both parts are explicitly present: the what ('Archive a completed change in the experimental workflow') and an explicit when ('Use when the user wants to finalize and archive a change after implementation is complete'). Not a 5 because the when-clause largely restates the what instead of adding concrete trigger variations or context; not a 3 because the 'when' is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

Natural trigger phrases are present — 'archive', 'finalize', 'completed change', 'after implementation is complete' — giving good keyword coverage a user would plausibly say. Not a 5 because common synonyms ('close out', 'wrap up', 'clean up a change') and the openspec/domain-specific vocabulary are missing; not a 3 because multiple relevant natural terms are covered, not just a domain label.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (archiving completed changes in a specific experimental workflow) with triggers ('archive', 'finalize') that are distinct from sibling skills like sync or status. Not a 5 because 'experimental workflow' is unnamed relative to openspec, leaving minor overlap risk with generic archiving requests; not a 3 because it is more specific than the 'could still overlap with similar skills' anchor.

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

TencentBlueKing/bk-bcs

Path

bcs-runtime/bcs-k8s/bcs-component/bcs-drplan-controller/.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.