migrate-specs

Migrates OpenSpec delta spec files to canonical spec directories with dry-run/apply options.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/TbK0ng/silver-bullet-kernel --skill migrate-specs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-specs
Source: https://github.com/TbK0ng/silver-bullet-kernel/tree/main/.agents/skills/migrate-specs
Command: npx skills add https://github.com/TbK0ng/silver-bullet-kernel --skill migrate-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of synchronizing changes made to OpenSpec delta specifications into the main canonical specifications, ensuring consistency without unnecessary archiving.

Core Features & Use Cases

  • Delta Spec Synchronization: Merges changes from openspec/changes/<change>/specs/*/spec.md into openspec/specs/*/spec.md.
  • Controlled Application: Provides explicit dry-run and apply options for migration.
  • Use Case: When developing new features or making updates that require spec modifications, use this skill to integrate those changes seamlessly into the main spec repository.

Quick Start

Use the migrate-specs skill to preview the migration of change ID 'feature-x'.

Frequently Asked Questions about migrate-specs

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

FAQPage Schema
How do I sync OpenSpec delta specifications into canonical specs?

To sync OpenSpec delta specifications, merge changes from the delta spec directories into the main spec directories using an explicit dry-run and apply flow. This integrates updates without archiving the source change.

Can I preview OpenSpec delta migrations before applying changes?

Yes, you can preview OpenSpec delta migrations using the explicit dry-run option. This validates the migration outcomes and updates task evidence rows before you commit the apply flow.

What is an OpenSpec delta specification?

An OpenSpec delta specification represents changes stored in openspec/changes/<change>/specs/*/spec.md. It needs synchronization to integrate seamlessly into the main canonical spec repository.

How do I migrate spec changes for a specific feature ID?

To migrate spec changes for a specific feature ID, run the synchronization process targeting that change ID. It merges the delta spec into the main openspec/specs directory and validates the outcome.

Does the OpenSpec migration process archive the source change files?

No, the OpenSpec synchronization process integrates delta specs into canonical specs without archiving the source change. The original delta specification files remain intact after the apply flow completes.

Why are my OpenSpec task evidence rows not updating after a spec migration?

Task evidence rows fail to update if the migration outcomes are invalid. Ensure you execute the full dry-run and apply flow correctly to validate the migration and successfully update task evidence rows.