openspec-archive-change

Archive completed openspec changes into a date-stamped directory.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/jonathanhu237/rota --skill openspec-archive-change-jonathanhu237
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/jonathanhu237/rota/tree/main/.claude/skills/openspec-archive-change
Command: npx skills add https://github.com/jonathanhu237/rota --skill openspec-archive-change-jonathanhu237

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive a completed change in the experimental workflow.

Core Features & Use Cases

  • Guides users through selecting an active change, validating artifacts and tasks, optionally syncing delta specs, and moving the change to openspec/changes/archive with a date-stamped name.
  • Preserves the .openspec.yaml during archiving.
  • Generates a clear summary including the change name, the used schema, the archive location, and the sync status, while surfacing warnings for incomplete artifacts or tasks.

Quick Start

Run the archive operation to move the selected change into openspec/changes/archive with the current date.

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 openspec safely?

To archive a completed change, you select an active change, validate its artifacts and tasks, optionally sync delta specs, and move it to openspec/changes/archive with the current date while preserving the .openspec.yaml file.

What does archiving a change in openspec actually do to the directory structure?

Archiving a change moves it from the active changes directory into openspec/changes/archive, renames it with the current date stamp, and preserves the .openspec.yaml configuration file throughout the process.

Do I need the openspec CLI installed to archive changes?

Yes, the openspec CLI must be available in your environment because the archival process depends on it to validate artifacts, optionally sync delta specs, and move the change to the archive directory.

Can I archive an openspec change if some tasks or artifacts are incomplete?

You can run the archive process on an incomplete change, but it validates artifacts and tasks and will surface warnings for incomplete items in the final summary before moving the change to the archive directory.

What happens to delta specs when archiving an openspec change?

Delta specs can be optionally synced during the archiving process, and the final summary will report the sync status alongside the change name, used schema, and archive location for tracking.

Why should I archive openspec changes instead of deleting them?

Archiving moves completed changes to a date-stamped directory while preserving the .openspec.yaml file, keeping a historical record of artifacts and tasks instead of permanently discarding the change data.