openspec-apply-change

Implements tasks from an OpenSpec change using the openspec CLI.

Updated Nov 7, 2023
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill openspec-apply-change-lstellway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-apply-change
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/openspec-apply-change
Command: npx skills add https://github.com/lstellway/nixfiles --skill openspec-apply-change-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns an OpenSpec change's task list into actual code changes, removing the manual work of tracking which tasks are done, reading the right context files, and keeping the tasks file updated during implementation. ## Core Features & Use Cases - Change Selection: Resolves the target change from a provided name, conversation context, or an interactive picker backed by openspec list --json. - Schema-Aware Context Loading: Runs openspec status and openspec instructions apply to discover the workflow schema and read the exact context files (proposal, specs, design, tasks) before writing any code. - Task-by-Task Implementation Loop: Works through pending tasks, marks each one complete in the tasks file, and pauses with structured status output when blocked, ambiguous, or finished. - Use Case: You have an approved OpenSpec change with 7 tasks. Invoke this skill to have the agent read the proposal and specs, implement each task in order, check off the tasks file, and report progress until the change is ready to archive. ## Quick Start Ask the agent to start implementing the tasks for your current OpenSpec change, optionally naming the change to apply.

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, or let it infer the change from context. It runs openspec status and openspec instructions apply to load context files, then implements each pending task and checks it off in the tasks file.

What happens if I don't specify which OpenSpec change to apply?

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

Does openspec-apply-change require the openspec CLI?

Yes, the openspec CLI is a hard requirement. The skill shells out to openspec list, status, and instructions apply commands to discover changes, schemas, context files, and task progress.

What happens when 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 before continuing with further tasks.

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

Yes, as long as tasks exist. The workflow is fluid: you can implement partially, update artifacts when implementation reveals design issues, and interleave other OpenSpec actions between sessions.