openspec-new-change

Scaffolds a new OpenSpec change directory with the artifact-driven workflow.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/zh-impact/agent-feeder --skill openspec-new-change-zh-impact
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/zh-impact/agent-feeder/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/zh-impact/agent-feeder --skill openspec-new-change-zh-impact

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new feature or fix with OpenSpec requires knowing the correct CLI commands, schema selection, and artifact ordering. This Skill walks through the setup so the change directory is created correctly and the first artifact template is ready. ## Core Features & Use Cases - Guided Change Creation: Derives a kebab-case change name from a plain-language description and runs openspec new change to scaffold the directory. - Workflow Schema Selection: Uses the default schema automatically, or a specific schema via --schema when the user requests one. - Artifact Status & Instructions: Shows which artifacts are ready via openspec status and retrieves the template for the first artifact with openspec instructions. - Use Case: A developer says "I want to add user authentication." The Skill derives the name add-user-auth, scaffolds the change, shows the artifact sequence, and presents the proposal template ready to draft. ## Quick Start Ask the assistant to start a new OpenSpec change for the feature or fix you want to build, and it will scaffold the change and show the first artifact template.

Frequently Asked Questions about openspec-new-change

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

FAQPage Schema
How do I start a new OpenSpec change?▼

Describe what you want to build, and the Skill derives a kebab-case name and runs `openspec new change <name>`. It then shows the artifact status and the template for the first artifact so you can begin drafting.

How do I use a different OpenSpec workflow schema?▼

Mention the schema name explicitly and the Skill passes `--schema <name>` to the CLI. If you ask what workflows exist, it runs `openspec schemas --json` so you can choose one.

Does this Skill create the proposal or spec artifacts for me?▼

No. It only scaffolds the change directory and displays the first artifact's template and instructions. Creating artifacts is a separate step you direct afterward.

What happens if the change name already exists?▼

The Skill suggests continuing the existing change instead of creating a duplicate. It also rejects names that are not valid kebab-case and asks for a valid one.

What are the requirements for using OpenSpec change scaffolding?▼

You need the openspec CLI installed in your environment. The Skill relies on commands like `openspec new change`, `openspec status`, and `openspec instructions` to function.