Agent-Skills.md

Agent Skills: OpenSpec Sync Specs

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

UncategorizedID: u473t8/learning-app/openspec-sync-specs

Repository

u473t8/learning-app
u473t8

Install this agent skill to your local

pnpm dlx add-skill https://github.com/u473t8/learning-app/tree/HEAD/.codex/skills/openspec-sync-specs

Skill Files

Browse the full folder contents for openspec-sync-specs.

Download Skill

Loading file tree…

.codex/skills/openspec-sync-specs/SKILL.md

Skill Metadata

Name
openspec-sync-specs
Description
Sync delta specs from an active OpenSpec change into the main specs without archiving the change. Use this when the user wants the spec updates now but wants to keep the change active.

OpenSpec Sync Specs

Use this skill when the user wants to update openspec/specs/ before archiving.

Workflow

  1. Resolve the target change.

  2. Find delta specs under:

openspec/changes/<name>/specs/*/spec.md

  1. For each delta spec:

    • read the delta spec
    • read the corresponding main spec under openspec/specs/<capability>/spec.md
    • merge changes intelligently instead of copying wholesale

  2. Handle sections intentionally:

    • ADDED Requirements: add missing requirements
    • MODIFIED Requirements: patch only the changed portions and preserve untouched scenarios
    • REMOVED Requirements: remove the requirement block
    • RENAMED Requirements: rename in place

  3. If the main spec does not exist:

    • create it with a short purpose section
    • add the new requirements from the delta

  4. Summarize which capabilities changed and how.

Notes

  • This skill is mainly for cases where the user wants specs synced before archive.
  • If the user is ready to close the change, openspec-archive-change is usually the better path.
  • In the repo delivery flow, sync specs before PR creation/merge when the change remains active; otherwise archive before PR creation/merge.
  • Use OpenSpec CLI with telemetry disabled by default:
OPENSPEC_TELEMETRY=0 openspec ...

Guardrails

  • Preserve existing content not mentioned by the delta.
  • Keep the merge idempotent.
  • Ask before making destructive removals when the delta is ambiguous.
OpenSpec Sync Specs Skill | Agent Skills