openspec-archive-change

Archive completed openspec changes after verifying artifacts, tasks, and delta specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines finalizing and archiving an experimental openspec change by verifying artifacts, tasks, and spec diffs so changes are closed cleanly and traceably.

Core Features & Use Cases

  • Change selection and confirmation: Prompts the user to pick an active change when none is provided and prevents accidental auto-selection.
  • Completion checks: Uses openspec list/status outputs and task files to detect incomplete artifacts or tasks and requests explicit user confirmation before proceeding.
  • Delta spec assessment and optional sync: Compares change delta specs with main specs, summarizes adds/edits/removals, and optionally triggers a spec sync before archiving.
  • Safe archive operation: Creates a dated archive directory, preserves configuration files, and moves the change directory with clear error handling for naming collisions.

Quick Start

Archive the change named my-change by running the openspec archive workflow, confirming any warnings about artifacts or tasks, and choosing whether to sync delta specs.

Frequently Asked Questions about openspec-archive-change

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

FAQPage Schema
How do I safely archive completed openspec changes and finalize the workspace state?

To archive completed openspec changes, the workflow verifies artifacts, tasks, and delta specs before moving the change directory into a dated archive, preserving configuration files and ensuring traceability.

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

When archiving an openspec change with incomplete artifacts or tasks, the workflow detects the issue using list and status outputs, then requests explicit user confirmation before proceeding with the archive operation.

Can I sync delta specs with main specs before moving an openspec change to the archive?

Yes, you can optionally trigger a spec sync before archiving. The workflow compares change delta specs with main specs, summarizes additions, edits, and removals, and optionally initiates the sync.

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

Yes, the openspec CLI is required for list and status operations to verify completion. The workflow also needs filesystem access to move directories and preserve configuration during the archive process.

How does the archive process handle naming collisions when moving openspec change directories?

The archive process creates a dated archive directory to prevent naming collisions and provides clear error handling if conflicts occur, ensuring the change directory is moved safely without data loss.

Why does the workflow prompt me to pick an active change instead of auto-selecting one to archive?

The workflow prompts you to pick an active change to prevent accidental auto-selection, ensuring you explicitly confirm the correct experimental openspec change before it is archived and finalized.