openspec-bulk-archive-change

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

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/openspec-bulk-archive-change/SKILL.md

Quality

Content

77%

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

A thorough, highly actionable batch-archive workflow with strong sequencing and validation for a destructive batch operation. Its main weakness is verbosity from redundant output examples and inline reference-style material that could be split into bundled files.

Suggestions

Collapse the 'Output On Success/Partial/No Changes' templates into a single parameterized example to remove overlap with step 9's summary.

Move the two 'Conflict Resolution Examples' into a referenced file (e.g. references/conflict-resolution.md) and link to it from step 5 to reduce the main body length.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with concrete commands, but the three 'Output On…' templates duplicate step 9's summary example and the Guardrails restate points already covered in the steps.	2 / 3
Actionability	Provides fully executable commands (openspec list/status --json, mkdir/mv), concrete file paths, and copy-paste-ready table and output formats throughout.	3 / 3
Workflow Clarity	A clear 9-step sequence with explicit validation checkpoints (batch validation, consolidated status table, single confirmation, per-change outcome tracking) and a feedback loop (archive target exists -> fail that change, continue).	3 / 3
Progressive Disclosure	The file is well-sectioned with clear headers, but at ~235 lines it is monolithic; conflict-resolution examples and the multiple output templates are inline when they could live in referenced files, and no bundle files are present.	2 / 3
	Total	10 / 12 Passed

Description

67%

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 concise, third-person description that clearly answers both what and when, with an explicit 'Use when' trigger. Its main weakness is narrow action coverage and missing the 'openspec' qualifier and common bulk/batch phrasing that would sharpen distinctiveness and trigger terms.

Suggestions

Add 'openspec' to the description so it is clearly scoped and less likely to conflict with generic archive skills.

Broaden the action list and trigger terms, e.g. 'Bulk-archive multiple completed openspec changes, resolving spec conflicts. Use when the user asks to archive, clean up, or batch-complete several parallel changes.'

Dimension	Reasoning	Score
Specificity	Names a concrete action ('Archive') and its object ('multiple completed changes at once'), but offers a single action rather than the multiple distinct actions the top anchor requires.	2 / 3
Completeness	Explicitly states both what it does ('Archive multiple completed changes at once') and when to use it ('Use when archiving several parallel changes').	3 / 3
Trigger Term Quality	Includes relevant natural terms like 'archive', 'changes', and 'archiving several parallel changes', but omits common variations a user might say such as 'bulk', 'batch', or 'completed specs'.	2 / 3
Distinctiveness Conflict Risk	The 'multiple/parallel changes' framing carves out a batch niche, but the description never mentions 'openspec', so it could still overlap with a single-change archive skill.	2 / 3
	Total	9 / 12 Passed

Validation

100%

Warnings & errors only

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: fengshao1227/ccg-workflow
Path: .agents/skills/openspec-bulk-archive-change/SKILL.md
Commit: 9eaff79

Reviewed: about 15 hours ago

Table of Contents

Discovery Implementation Validation

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.