openspec-apply-change

Implements tasks from an OpenSpec change proposal while keeping task lists and specs synchronized.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/AlmogMaayan/ptp --skill openspec-apply-change-almogmaayan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-apply-change
Source: https://github.com/AlmogMaayan/ptp/tree/main/skills/openspec-apply-change
Command: npx skills add https://github.com/AlmogMaayan/ptp --skill openspec-apply-change-almogmaayan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved change proposal into working code often loses track of which tasks are done, which remain, and whether the specs still match the implementation. This Skill drives the implementation loop task by task, keeping the task checklist and specs in step as work progresses. ## Core Features & Use Cases - Change selection and status inspection: Resolves the target change from a name, conversation context, or an interactive picker backed by openspec list --json, then reads schema and progress via openspec status and openspec instructions apply. - Task-by-task implementation loop: Reads the context files the CLI lists (specs, tasks, design, proposal), implements each pending task with minimal scoped edits, and flips - [ ] to - [x] immediately after completion. - Structured pause and completion reporting: Emits progress summaries ("N/M tasks complete"), pauses with options on ambiguity, design issues, or blockers, and suggests archiving when all tasks finish. - Use Case: After approving an OpenSpec proposal for a new API endpoint, run the apply step to have the agent implement each planned task in order, updating the tasks file as it goes and pausing for guidance if a design flaw surfaces. ## Quick Start Ask the agent to apply the OpenSpec change named add-user-auth and implement its remaining tasks one by one.

Frequently Asked Questions about openspec-apply-change

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

FAQPage Schema
How do I implement an OpenSpec change proposal task by task?▼

Run the apply flow with a change name: it calls openspec status and openspec instructions apply to load context files and the task list, then implements each pending task, marking `- [ ]` as `- [x]` after each one until done or blocked.

How does the skill pick which change to apply?▼

It uses a provided name first, otherwise infers from conversation context or auto-selects when only one active change exists. If ambiguous, it runs openspec list --json and asks you to choose with the AskUserQuestion tool.

Does openspec apply require the openspec CLI installed?▼

Yes, the openspec CLI is required. The skill shells out to openspec status, openspec instructions apply, and openspec list to discover schema, context files, and progress, so the CLI must be available on the system.

What happens if implementation gets blocked or a task is unclear?▼

The skill pauses instead of guessing. It reports the issue, current progress, and a set of options, then waits for your guidance; if implementation reveals a design problem, it suggests updating the change artifacts.

Can I apply a change before all its artifacts are complete?▼

Yes, the workflow is fluid: you can apply whenever tasks exist, interleave with other actions, and update artifacts mid-implementation. If required artifacts are missing, the CLI returns a blocked state and the skill suggests continuing the change first.