skills.rest
twaananen
twaananenCOMMUNITY
Explore all skills by this author →
GitHub

openspec-new-change

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

Updated Mar 13, 2026
Search Tags:#cli#spec-driven development#kebab-case#openspec#artifact workflow#change scaffolding
One-click install
npx skills add https://github.com/twaananen/6dof-drone-sim --skill openspec-new-change-twaananen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/twaananen/6dof-drone-sim/tree/main/.agents/skills/openspec-new-change
Command: npx skills add https://github.com/twaananen/6dof-drone-sim --skill openspec-new-change-twaananen

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 guides the AI through scaffolding a new change correctly so you get a structured, step-by-step workflow without memorizing the openspec CLI. ## Core Features & Use Cases - Change Scaffolding: Runs openspec new change to create a scaffolded change directory under openspec/changes/<name>/ with the selected schema. - Schema Selection: Uses the default workflow by default, or a specific schema via --schema when the user requests one, with discovery through openspec schemas --json. - Artifact Guidance: Shows artifact status with openspec status and retrieves the template for the first ready artifact via openspec instructions. - Use Case: You describe "add user authentication" and the Skill derives the kebab-case name add-user-auth, creates the change, and presents the first artifact template ready for drafting. ## Quick Start Ask the AI 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, then runs `openspec new change <name>` to scaffold the change under `openspec/changes/<name>/`. It then shows artifact status and the first artifact template.

How do I use a different OpenSpec workflow schema?▼

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

Does this Skill create the change artifacts automatically?▼

No. It only scaffolds the change directory and displays the template for the first ready artifact. It explicitly stops and waits for your direction before drafting any artifact content.

What happens if the change name is invalid or already exists?▼

If the name is not kebab-case, the Skill asks for a valid name. If a change with that name already exists, it suggests continuing that existing change instead of creating a duplicate.

What do I need installed to use OpenSpec change scaffolding?▼

You need the openspec CLI installed and available in your environment. The Skill runs commands like `openspec new change`, `openspec status`, and `openspec instructions` against it.

Related Skills

Explore More Software Engineering Skills→
SinesysTechSinesysTech

openspec-new-change

Scaffold a change directory for new features, fixes, or modifications in OpenSpec.

Official
Intermediate
manishsinghmfmanishsinghmf

openspec-continue-change

Generate the next OpenSpec artifact from ready artifacts using templates.

Community
Advanced
studyzystudyzy
10.3k

openspec-continue-change

Creates the next artifact to advance an OpenSpec change workflow.

Community
Intermediate
sgiathsgiath
4

openspec-new-change

Scaffold a new OpenSpec change directory with an artifact-driven workflow.

Community
Intermediate