openspec-archive-change

Archive completed openspec change directories after verifying artifacts and tasks.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/cenmiao/openspec-pro --skill openspec-archive-change-cenmiao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/cenmiao/openspec-pro/tree/main/.claude/skills/openspec-archive-change
Command: npx skills add https://github.com/cenmiao/openspec-pro --skill openspec-archive-change-cenmiao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines finalizing and archiving implemented changes in an openspec experimental workflow by ensuring artifacts and tasks are reviewed, delta specs are evaluated for sync, and the change directory is moved to a dated archive location with confirmation and safeguards.

Core Features & Use Cases

  • Guided selection: Prompts the user to select an active change when a name is not provided, avoiding accidental archives.
  • Completion checks: Verifies artifact completion via openspec status and scans task lists for incomplete items, warning and requesting confirmation when necessary.
  • Delta spec assessment and optional sync: Compares change delta specs to main specs, summarizes diffs, and offers to sync before archiving while preserving repository metadata.
  • Safe archival: Creates a dated archive directory, prevents overwriting existing archives, and moves the change while keeping .openspec.yaml intact.
  • Use Case: When a feature branch is implemented and you want to finalize the change, confirm everything is done, optionally sync spec updates, and move the change to a historical archive.

Quick Start

Archive the change named improve-auth by checking artifacts and tasks, assessing any delta specs for sync, and then move the change into openspec/changes/archive with a dated folder.

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 completed changes in an openspec workflow?

To archive completed changes, the skill selects an active change directory, verifies artifact and task completion via openspec status, optionally syncs delta specs, and moves the folder to a dated archive location with user confirmation.

What happens if I try to archive an openspec change with incomplete tasks?

When archiving a change with incomplete tasks, the skill scans task lists, warns you about incomplete items, and requests explicit confirmation before proceeding with the destructive move operation to the archive.

Do I need the openspec CLI to finalize and archive change directories?

Yes, you need the openspec CLI installed and accessible, as the skill relies on it for listing active changes and querying artifact completion status before moving any directories to the archive.

Can I sync delta specs to main specs before archiving a change?

Yes, you can sync delta specs before archiving; the skill compares change delta specs to main specs, summarizes the diffs, and offers to sync while preserving repository metadata before moving the change directory.

How does openspec prevent overwriting existing change archives?

Openspec prevents overwriting by creating a uniquely dated archive directory for each finalized change, ensuring existing archives remain intact while keeping the .openspec.yaml configuration file preserved during the move.