openspec-bulk-archive-change

Archives multiple completed OpenSpec changes in one batch with conflict-aware spec syncing.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/JhonMA82/api-starter --skill openspec-bulk-archive-change-jhonma82
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/JhonMA82/api-starter/tree/main/.opencode/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/JhonMA82/api-starter --skill openspec-bulk-archive-change-jhonma82

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Archiving many completed OpenSpec changes one by one is slow and error-prone, especially when several changes touch the same capability spec. This Skill batches the whole operation: it collects status for every selected change, detects spec conflicts, resolves them by checking the codebase for actual implementations, and archives everything in a single confirmed pass. ## Core Features & Use Cases - Batch archiving: Select any number of active changes (1+ works, 2+ is typical) and archive them together with one confirmation. - Conflict detection and resolution: When two or more changes modify the same capability spec path, the Skill inspects the codebase to decide which delta specs to sync, applying both in chronological order when both are implemented. - Verified spec sync: Before moving any change into the archive directory, it runs the openspec-sync-specs workflow inline and verifies that ADDED, MODIFIED, REMOVED, and RENAMED requirements landed correctly in the main specs. - Use Case: After a sprint where five parallel changes (add-oauth, add-jwt, schema-management, project-config, add-verify-skill) were completed, run this Skill to review a consolidated status table, resolve the identity/user-auth spec conflict, and archive all ready changes at once. ## Quick Start Ask the assistant to bulk archive all completed OpenSpec changes and confirm the batch when the status table is shown.

Frequently Asked Questions about openspec-bulk-archive-change

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive multiple OpenSpec changes at once?▼

Run the bulk archive workflow, which lists all active changes, prompts you to multi-select the ones to archive, shows a consolidated status table, and asks for a single confirmation before archiving the batch.

What happens when two changes modify the same spec in OpenSpec?▼

The workflow detects the conflict by capability path, reads both delta specs, and searches the codebase for implementation evidence. If both are implemented it applies them chronologically; if only one is implemented it syncs that one; if neither is found it skips the sync with a warning.

Does bulk archive work with OpenSpec stores?▼

Yes. If the work lives in a registered store, the workflow discovers store ids with openspec store list --json and passes --store <id> on all commands that read or write specs and changes, keeping the flag sticky for the whole batch.

Can I archive a change with incomplete tasks in OpenSpec?▼

Yes, but the status table marks it with warnings showing incomplete artifacts and tasks. At confirmation you can choose to archive everything including incomplete changes, archive only the ready ones, or cancel the batch entirely.

Why did a change fail to archive during a bulk operation?▼

A change fails if its spec sync verification does not match the delta specs or if the archive target directory already exists. Failed changes are reported individually while the rest of the batch continues, and their changeRoot is left intact.