CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-bulk-archive-change

Archive multiple completed changes at once. Use when archiving several parallel changes.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/openspec-bulk-archive-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

The content is a strong, highly actionable workflow: concrete CLI commands, conflict-detection logic grounded in codebase evidence, user confirmation before the destructive batch, and complete outcome reporting. Weaknesses are limited to moderate redundancy between the step-9 example and the Output sections, and the underspecified spec-sync delegation in step 8a. Consolidating the duplicated output templates and inlining (or referencing) the sync-specs mechanics would lift it further.

Suggestions

Remove the duplication between step 9's example summary and the 'Output On Success'/'Output On Partial Success' templates — keep one canonical output format.

Tighten the 'Conflict Resolution Examples' section or move it to a reference file, since it restates step 5's decision logic that is already fully specified.

Inline the key mechanics of the 'openspec-sync-specs approach' (or at least its concrete steps) instead of delegating the core spec-sync action to another skill by name only.

DimensionReasoningScore

Conciseness

The body is mostly lean with concrete commands and no padding of known concepts, but there is real redundancy: step 9's example summary duplicates the 'Output On Success' template almost verbatim, and the two 'Conflict Resolution Examples' re-illustrate logic already specified in step 5. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is above score 2 (no verbose concept explanations) but below score 4 because the duplication is more than a minor trim.

3 / 5

Actionability

The workflow gives concrete, executable commands (`openspec list --json`, `openspec status --change "<name>" --json`, `mkdir -p`/`mv`), exact table formats, and output templates. The minor gap is step 8a's 'Use the openspec-sync-specs approach (agent-driven intelligent merge)', which delegates the core spec-sync action to another skill without any inline detail — matching 'mostly executable guidance; concrete code or commands with minor gaps' rather than the fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The 9-step sequence is clearly ordered with explicit validation checkpoints at every risky stage: batch status gathering (step 3), conflict detection (step 4), codebase-evidence resolution (step 5), a consolidated status table (step 6), and a single user confirmation before the destructive batch (step 7), followed by per-change outcome tracking and a failure-continuation rule ('If archive target exists, fail that change but continue with others'). Despite being a destructive batch operation, validation and feedback loops are present, so the batch-operation cap does not apply and the content matches the anchor-5 example's validate-before-proceeding pattern.

5 / 5

Progressive Disclosure

The body is a single well-organized file with clear sections (Steps, Conflict Resolution Examples, Output templates, Guardrails) and no bundle files exist to reference, so there is no buried or nested-reference problem. It falls short of score 5 because at ~240 lines the example-heavy material (conflict examples, output templates) could arguably be split into a separate reference file, matching 'good structure; most content appropriately placed; minor organization gaps' rather than a cleanly split overview.

4 / 5

Total

16

/

20

Passed

Description

62%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.

The description is concise, uses third person, and answers both what and when, but it undersells the skill's capabilities and has thin trigger coverage. Users asking to 'batch archive', 'bulk archive', or 'clean up completed openspec changes' would not reliably match it. Mentioning openspec and one or two more concrete capabilities would materially improve it.

Suggestions

Add a second concrete capability so specificity rises, e.g. 'Detects and resolves spec conflicts between changes by checking what is actually implemented in the codebase.'

Broaden the trigger clause with natural synonyms: 'Use when archiving several parallel changes, batch-archiving completed changes, or cleaning up finished openspec changes.'

Include the 'openspec' keyword in the description to reduce overlap risk with generic archive/cleanup skills and improve distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('Archive multiple completed changes at once') with only one concrete action, while the skill body performs several more (conflict detection, spec syncing, status validation) that go unmentioned. Scoring only what is stated, this matches 'names domain and 1-2 concrete actions, but not comprehensive'; it is not score 4 because there is no list of several specific actions, and not score 2 because the action given is concrete rather than generic.

3 / 5

Completeness

Both questions are answered: what ('Archive multiple completed changes at once') and when ('Use when archiving several parallel changes'). It is not score 5 because the 'when' clause is a single thin condition without concrete trigger phrases or synonyms, matching 'has both what and when; when could be more explicit or specific' rather than the fully explicit anchor.

4 / 5

Trigger Term Quality

Trigger keywords are limited to 'archive', 'changes', and 'several parallel changes' — relevant but missing common natural variations a user would say, such as 'bulk', 'batch', 'cleanup', or 'completed changes'. This matches 'some relevant keywords but missing common variations or synonyms'; score 4 would require good coverage of natural phrasings, which is not present.

3 / 5

Distinctiveness Conflict Risk

The batch-archive-of-changes niche is fairly distinct, but the description never mentions 'openspec' or the tool context, so 'changes' could overlap with generic archive, cleanup, or git skills. This fits 'mostly distinct; minor overlap risk with closely related skills'; it is not score 5 because the distinct triggers are not fully specific to this skill's domain.

4 / 5

Total

14

/

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-bulk-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.