openspec-archive-change

Archives completed OpenSpec changes and syncs delta specs into main specs.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/74th/test-llm-agent --skill openspec-archive-change-74th
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/74th/test-llm-agent/tree/main/20260922-openai-agentapi-selfhosted-sandbox/.agents/skills/openspec-archive-change
Command: npx skills add https://github.com/74th/test-llm-agent --skill openspec-archive-change-74th

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finalizing a completed OpenSpec change involves checking artifact and task completion, reconciling delta specs with main specs, and moving the change into an archive directory; doing this manually is error-prone and easy to get wrong. ## Core Features & Use Cases - Guided change selection: Infers the change from context, auto-selects when only one active change exists, or prompts with a list of active changes. - Completion and sync checks: Verifies artifact status via openspec status --json, checks tasks.md for incomplete checkboxes, and assesses whether delta specs need syncing into main specs before archiving. - Safe archiving with verification: Runs the inline spec-sync workflow when requested, verifies the merged main specs, then moves the change into a date-prefixed archive folder with a clear summary. - Use Case: After finishing implementation of a user-auth change, ask the agent to archive it; the skill confirms tasks are done, syncs the delta spec into openspec/specs/user-auth/spec.md, and moves the change to changes/archive/2026-09-22-user-auth/. ## Quick Start Ask the agent to archive the completed OpenSpec change named add-user-auth and sync its delta specs first.

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 a completed OpenSpec change?▼

Invoke the archive workflow with a change name or let it be inferred from context. The skill checks artifact and task completion, optionally syncs delta specs into main specs, then moves the change directory into a YYYY-MM-DD-prefixed archive folder.

How to sync delta specs into main specs before archiving?▼

When delta specs exist, the skill compares each delta against its main spec and offers a sync option. Choosing sync runs the openspec-sync-specs workflow inline, then re-verifies every capability before the archive move proceeds.

Does openspec archive work without an openspec project root?▼

No. The skill checks for a root via openspec list --json before any write. If no root exists and OpenSpec was explicitly requested, it asks whether to run openspec init, target a registered store, or continue without OpenSpec.

Can I archive a change with incomplete tasks or artifacts?▼

Yes, but with confirmation. The skill warns about incomplete artifacts or unchecked tasks in tasks.md and asks you to confirm before proceeding; the warnings are noted in the final archive summary.

What happens if the archive target directory already exists?▼

The archive fails with an error before moving anything. The skill suggests renaming the existing archive entry or using a different date prefix, and the change directory remains untouched.