openspec-archive-change-ai-kit

Archives completed OpenSpec changes after validating artifacts and tasks, optionally syncing specs before moving to timestamped location.

Updated May 11, 2026
One-click install
npx skills add https://github.com/ducthang-hub/nw-ai-kit --skill openspec-archive-change-ai-kit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change-ai-kit
Source: https://github.com/ducthang-hub/nw-ai-kit/tree/main/.agents/skills/openspec-archive-change-ai-kit
Command: npx skills add https://github.com/ducthang-hub/nw-ai-kit --skill openspec-archive-change-ai-kit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you finalize and archive an OpenSpec change in an experimental workflow while validating that artifacts and tasks are complete, preventing accidental archival of unfinished work.

Core Features & Use Cases

  • Archive completed changes: Moves a completed change directory into a timestamped archive location.
  • Completion validation with prompts: Checks artifact completion via openspec status and task completion via tasks.md, warning and requiring confirmation when incomplete items exist.
  • Delta spec sync assessment: Detects delta specs and compares them against main specs to summarize differences, then optionally syncs before archiving.
  • Use Case: After implementing and finishing a change under openspec/changes/<name>, run this Skill to archive the change and ensure its spec updates are consistent.

Quick Start

Archive the completed change named "my-change" from the experimental workflow.

Frequently Asked Questions about openspec-archive-change-ai-kit

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

FAQPage Schema
How do I archive a completed OpenSpec change safely?

Archiving a completed OpenSpec change requires validating artifacts via openspec status and tasks.md, optionally syncing delta specs under openspec/changes/<name>/specs/, then moving the directory into a timestamped archive location.

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

When archiving an OpenSpec change with incomplete tasks or artifacts, the process detects incomplete items via openspec status and tasks.md, warns the user, and requires explicit confirmation before proceeding with the archival move.

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

Yes, openspec CLI support is required to archive changes, because the process executes openspec list and openspec status commands to validate artifact completion and check task status before moving the directory.

How are delta specs handled during OpenSpec workflow finalization?

During OpenSpec workflow finalization, delta specs under openspec/changes/<name>/specs/ are detected and compared against main specs to summarize differences, then optionally synced via an openspec-sync-specs approach before archiving.

When should I not archive an OpenSpec change directory?

You should not archive an OpenSpec change directory when artifact validation via openspec status or task completion checks in tasks.md reveal incomplete deliverables, as the workflow is designed to prevent accidental archival of unfinished work.