openspec-apply-change

Implement tasks from an OpenSpec change using the openspec CLI.

1|Updated Aug 21, 2023
One-click install
npx skills add https://github.com/jmuchovej/homelab --skill openspec-apply-change-jmuchovej
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-apply-change
Source: https://github.com/jmuchovej/homelab/tree/main/.agents/skills/openspec-apply-change
Command: npx skills add https://github.com/jmuchovej/homelab --skill openspec-apply-change-jmuchovej

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the guesswork of turning an OpenSpec change proposal into working code by walking through the change's task list, reading the right context files, and tracking progress until every task is done or blocked. ## Core Features & Use Cases - Change selection and status inspection: Resolves the target change from user input or conversation context, then reads schema, progress, and task state via openspec status and openspec instructions apply. - Guided task implementation loop: Reads context files (proposal, specs, design, tasks), implements each pending task, and marks checkboxes complete as it goes. - Blocked and completion handling: Detects blocked or all-done states, suggests next actions such as creating missing artifacts or archiving the change. - Use Case: After drafting a spec-driven change for a new auth feature, run the skill to implement all seven tasks in order, pausing automatically when a design issue surfaces. ## Quick Start Ask the assistant to implement the tasks for your OpenSpec change, optionally naming the change, for example by saying to apply the change add-auth.

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 tasks from an OpenSpec change?

Invoke the skill with an optional change name, such as /openspec-apply-change add-auth. It runs openspec status and openspec instructions apply to load context files and the task list, then implements each pending task and marks it complete.

What happens if I don't specify a change name?

The skill infers the change from conversation context or auto-selects when only one active change exists. If the choice is ambiguous, it runs openspec list --json and asks you to pick a change.

Does openspec-apply-change require the openspec CLI?

Yes, the skill requires the openspec CLI to be installed, since all status, instructions, and listing operations run through openspec commands. It also supports registered stores via the --store flag.

What does the skill do when a change is blocked?

When the apply instructions return a blocked state due to missing artifacts, it shows the message and suggests creating the missing artifact, for example via /openspec-continue-change or openspec instructions for the next artifact.

When does the skill pause instead of completing a task?

It pauses when a task is unclear, implementation reveals a design issue, work exceeds what the spec describes, or an error occurs. It never silently narrows or defers specified behavior and only marks tasks complete when fully implemented.