openspec-archive-change

Archive completed OpenSpec changes with date-prefixed directories.

2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/yandiaan/penginfo-handal-hackathon --skill openspec-archive-change-yandiaan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/yandiaan/penginfo-handal-hackathon/tree/main/.qoder/skills/openspec-archive-change
Command: npx skills add https://github.com/yandiaan/penginfo-handal-hackathon --skill openspec-archive-change-yandiaan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archives a completed change in the experimental OpenSpec workflow to preserve history, governance, and traceability after implementation is finished.

Core Features & Use Cases

  • Prompts for selecting an active change when none is provided
  • Checks artifact completion status via openspec status and lists any incomplete items
  • Evaluates task completion from a tasks file and warns about outstanding tasks
  • Detects delta specs and optionally syncs them against main specs before archiving
  • Creates an archive directory and moves the change to openspec/changes/archive/YYYY-MM-DD-<name>, preserving configuration files
  • Preserves the .openspec.yaml file as it moves

Quick Start

Provide the change name to archive, then follow prompts to verify status and move the change under openspec/changes/archive/YYYY-MM-DD-<name>.

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 OpenSpec workflow changes while preserving history?

OpenSpec change archival moves completed changes into openspec/changes/archive/YYYY-MM-DD-<name> to preserve traceability. It validates artifact completion via openspec status, checks outstanding tasks, optionally syncs delta specs, and relocates the change folder while preserving the .openspec.yaml configuration file.

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

Archiving an OpenSpec change with incomplete items triggers validation checks. The Skill runs openspec status to list incomplete artifacts and parses the tasks file to warn about outstanding tasks, ensuring you are notified of unfinished work before the change is moved to the archive directory.

Can I synchronize delta specs against main specs before moving a change to the archive?

Yes, delta specs can be synchronized before archiving an OpenSpec change. The Skill detects delta specs and optionally syncs them against main specs during the archival process to ensure the specification repository remains consistent and up to date.

When should I archive a change in the experimental OpenSpec workflow?

You should archive a change in the experimental OpenSpec workflow when implementation is finished and you need to preserve history and governance. Archiving moves the change from the active directory into a date-prefixed archive folder for long-term traceability.

Do I need to provide a change name to start the OpenSpec archival process?

You do not need to provide a change name upfront to start the OpenSpec archival process. If no change name is provided, the Skill prompts you to select an active change from the available list to proceed with validation and archiving.