openspec-archive-change

Archive completed OpenSpec changes after validating artifact and task status.

22|1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/izzoa/polyrouter --skill openspec-archive-change-izzoa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/izzoa/polyrouter/tree/main/.claude/skills/openspec-archive-change
Command: npx skills add https://github.com/izzoa/polyrouter --skill openspec-archive-change-izzoa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps finalize an already-implemented OpenSpec change by checking completion status, warning about unfinished work, and moving the change into the archive location.

Core Features & Use Cases

  • Change selection: Lists active changes when no target is provided so the user can choose the correct one.
  • Completion checks: Verifies artifact status, task completion, and delta spec sync state before archiving.
  • Archive workflow: Creates the archive path, prevents collisions, and moves the change into dated archive storage.
  • Use case: A team finishes a feature branch in OpenSpec and uses this Skill to confirm the work is complete, optionally sync specs, and archive the change cleanly.

Quick Start

Archive the completed OpenSpec change named "billing-routing-update" and summarize any unfinished artifacts or tasks before moving it to the archive.

Frequently Asked Questions about openspec-archive-change

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

FAQPage Schema
How do I archive a completed OpenSpec change safely?

To archive a completed OpenSpec change safely, the workflow validates artifact status, confirms task completion, and optionally synchronizes specs before moving the change into dated archive storage using the openspec CLI.

What happens if I try to archive an OpenSpec change with unfinished tasks?

Archiving an OpenSpec change with unfinished tasks triggers a warning. The process inspects artifact status and task completion beforehand, alerting you to incomplete work before proceeding with the archive relocation.

Do I need the openspec CLI to archive change management files?

Yes, you need the openspec CLI installed. This archival process relies on the CLI to handle change listing, status inspection, and the commands required to move completed changes into archive storage.

Can I select which specific change to archive if I have multiple active OpenSpec changes?

Yes, you can select a specific change. When no target change is provided, the workflow lists active OpenSpec changes, allowing you to inspect completion status and choose the correct one for archiving.

How does spec synchronization work when archiving an OpenSpec change?

Spec synchronization is an optional step during OpenSpec change archiving. It checks the delta spec sync state before finalizing the workflow, ensuring your specifications remain updated prior to moving the change into the archive.

What is the best way to prevent naming collisions when archiving OpenSpec changes?

The best way to prevent naming collisions is using the built-in archive workflow, which creates a uniquely dated archive path for each change, preventing conflicts before moving the finalized OpenSpec change into storage.