CtrlK
BlogDocsLog inGet started
Tessl Logo

openspec-bulk-archive-change

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

58

Quality

66%

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 ./.codex/skills/openspec-bulk-archive-change/SKILL.md

The canonical home for this skill is openspec-bulk-archive-change in Draculabo/AntigravityManager

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.

A strong operational skill: the workflow is unambiguous, validated, and safe for a destructive batch operation, with concrete commands throughout. Its weaknesses are redundancy — repeated output templates and guardrails that restate step rules — and one underspecified hand-off to the sync-specs approach.

Suggestions

Collapse the step-9 example summary and the 'Output On Success/Partial Success' templates into one template section to remove near-verbatim duplication.

Trim Guardrails to only rules not already stated in the steps (e.g. keep the .openspec.yaml and date-format rules, drop the re-statements of prompting and chronological order).

Replace 'Use the openspec-sync-specs approach' with a one-line inline description of the merge mechanics or a concrete file reference.

DimensionReasoningScore

Conciseness

The procedural steps are tight and command-driven, but there is real duplication: step 9's full example summary is repeated almost verbatim in the 'Output On Success' template, and several Guardrails ('Always prompt for selection, never auto-select', 'apply specs in chronological order') restate rules already given in the steps. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the efficient anchor.

3 / 5

Actionability

Nearly every step is executable: `openspec list --json`, `openspec status --change "<name>" --json`, checkbox-counting rules (`- [ ]` vs `- [x]`), the `### Requirement:` extraction pattern, and copy-paste bash for the archive move. The minor gap keeping it from a 5 is step 8a's 'Use the openspec-sync-specs approach (agent-driven intelligent merge)', which defers the most delicate operation to another skill's approach without inline mechanics.

4 / 5

Workflow Clarity

Nine explicitly sequenced steps with real validation checkpoints for a batch/destructive operation: pre-flight status gathering (step 3), a consolidated status table with warnings (step 6), a single user confirmation before execution (step 7), per-change outcome tracking (success/failed/skipped), and explicit failure recovery ('If archive target exists, fail that change but continue with others'). This matches the anchor requiring explicit validation, error recovery, and checklist-style structure.

5 / 5

Progressive Disclosure

The body is well-sectioned (Steps, Conflict Resolution Examples, Output templates, Guardrails) with no nested references and clear navigation, and no bundle files exist to consult. Minor gaps: the ~250-line body duplicates its output templates inline where a single template or a reference file would do, and 'the openspec-sync-specs approach' is an unsignaled external reference. This places it just below the well-split anchor at 5.

4 / 5

Total

16

/

20

Passed

Description

58%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 correctly follows the what + 'Use when...' pattern in third person, but it is thin: it never grounds the skill in openspec, covers only one of the skill's several capabilities, and its trigger clause largely duplicates the capability statement. It would benefit from domain naming and richer trigger phrasing.

Suggestions

Name the domain explicitly, e.g. 'Bulk-archive completed openspec changes, syncing delta specs and resolving spec conflicts by checking the codebase.'

Broaden the trigger clause with natural variations: 'Use when archiving several parallel openspec changes, cleaning up completed changes, or doing a bulk archive.'

Mention the conflict-resolution and spec-sync capabilities so the description reflects what the skill actually does.

DimensionReasoningScore

Specificity

The phrase 'Archive multiple completed changes at once' names the domain (completed changes) and one concrete action (batch archive), but stops there — no mention of spec syncing, conflict resolution, or status reporting that the skill actually performs. This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' and falls below the score-4 anchor, which lists several specific actions.

3 / 5

Completeness

Both 'what' ('Archive multiple completed changes at once') and 'when' ('Use when archiving several parallel changes') are present, but the 'when' clause nearly restates the 'what' without adding concrete trigger conditions — matching 'has both what and when; when could be more explicit or specific'. Not a 3 because the explicit 'Use when...' clause exists and is unambiguous.

4 / 5

Trigger Term Quality

'Use when archiving several parallel changes' supplies relevant keywords ('archive', 'changes', 'parallel') but misses common variations users would naturally say — 'bulk archive', 'cleanup completed changes', 'openspec'. It sits at 'some relevant keywords but missing common variations or synonyms', below the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

'Changes' is generic without the openspec context — the description never names openspec — so it could overlap with skills about code changes, git changes, or changelogs. This fits 'somewhat specific but could still overlap with similar skills' rather than the mostly-distinct anchor.

3 / 5

Total

13

/

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
Draculabo/AntigravityManager
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.