openspec-archive-change

Archive completed experimental workflow changes after validating artifacts and tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you safely finalize and archive completed changes in an experimental workflow by verifying artifact completion, task completion, and optional delta-spec synchronization before moving the change into an archive location.

Core Features & Use Cases

  • Artifact completion verification: Uses openspec-cn status to confirm all artifacts are marked done, and warns when they are not.
  • Task completion checks: Reads the tasks file (e.g., tasks.md) to detect unfinished items and warns accordingly.
  • Delta spec sync evaluation (optional): Detects incremental specs under openspec/changes/<name>/specs/ and compares them to main capability specs, prompting the user to choose syncing vs archiving without syncing.
  • Archiving with safe naming: Moves openspec/changes/<name> into openspec/changes/archive/YYYY-MM-DD-<name> while handling collisions to avoid overwriting.

Quick Start

Archive a completed change by providing its name, for example ask: “Archive the completed experimental change named ‘CHANGE_ABC’ after checking artifacts, tasks, and whether delta specs need synchronization.”

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 experimental workflow changes safely?

To archive completed experimental workflow changes safely, this skill validates artifact completion status via openspec-cn CLI, checks tasks files for unfinished items, and moves the change directory into a date-stamped archive folder to prevent data loss.

What happens if delta specs differ from main specifications during archiving?

When delta specs differ from main specifications during archiving, the skill detects incremental spec changes and prompts the user to choose between synchronizing with main capability specs via a subagent or archiving the change without syncing.

Do I need the openspec-cn CLI to finalize and archive spec changes?

Yes, you need the openspec-cn CLI available to finalize and archive spec changes, as the workflow relies on it to list changes and check completion status by parsing JSON output for guardrailed validation.

How does the archiving process handle directory name collisions?

The archiving process handles directory name collisions by moving the experimental change into openspec/changes/archive/YYYY-MM-DD-<name> with safe naming conventions that prevent overwriting any existing archived artifacts.

Can I archive an experimental change if some tasks are not marked done?

You can attempt to archive an experimental change with unfinished tasks, but the skill performs guardrailed completion checks by reading tasks.md and will issue warnings if artifacts are not marked done or if unfinished items are detected.