skills.rest
lstellway
lstellwayCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-new-change

Scaffolds a new OpenSpec change directory and displays the first artifact instructions.

Updated Nov 7, 2023
Search Tags:#spec-driven development#kebab-case#openspec#cli workflow#change scaffolding#artifact template
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill openspec-new-change-lstellway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/openspec-new-change
Command: npx skills add https://github.com/lstellway/nixfiles --skill openspec-new-change-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a structured spec-driven change requires knowing the OpenSpec CLI commands, schema selection, and artifact ordering. This Skill walks through the correct sequence so a new change is scaffolded properly without memorizing the workflow. ## Core Features & Use Cases - Change Scaffolding: Runs openspec new change to create a scaffolded change directory under openspec/changes/<name>/ with the selected schema. - Artifact Status Inspection: Runs openspec status to show which artifacts are ready and which dependencies remain. - First Artifact Guidance: Retrieves the template and context for the first ready artifact via openspec instructions, then stops for user direction. - Use Case: A developer wants to add user authentication to their project. They describe the goal, the Skill derives the kebab-case name add-user-auth, scaffolds the change, and presents the proposal template ready to draft. ## Quick Start Ask the assistant to start a new OpenSpec change for the feature 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?▼

Run `openspec new change "<name>"` with a kebab-case name to scaffold a change directory under `openspec/changes/<name>/`. Then run `openspec status --change "<name>"` to see which artifacts are ready to create.

How do I choose a workflow schema in OpenSpec?▼

Omit the `--schema` flag to use the default workflow. Pass `--schema <name>` only when you need a specific workflow, or run `openspec schemas --json` to list available schemas and choose one.

What happens after creating an OpenSpec change?▼

The Skill shows the artifact status and retrieves instructions for the first ready artifact using `openspec instructions <artifact-id> --change "<name>"`. It then stops and waits for your direction before drafting any artifacts.

What if my OpenSpec change name is invalid?▼

Change names must be kebab-case, such as `add-user-auth`. If the name is invalid you will be asked for a valid one, and if a change with that name already exists, continuing that change is suggested instead.

Does this Skill create the change artifacts automatically?▼

No. It only scaffolds the change directory and displays the first artifact template. Guardrails explicitly prevent creating artifacts or advancing beyond showing the first template until you provide direction.

Related Skills

Explore More Software Engineering Skills→
wtg42wtg42

openspec-onboard

Guide OpenSpec CLI users through a complete change workflow with proposal, specs, design, tasks, and archive artifacts.

Community
Intermediate
SynthropicTechnologySynthropicTechnology

openspec-new-change

Scaffold OpenSpec change directories with workflow schemas and artifact templates.

Official
Advanced
runtime-envruntime-env
47

openspec-continue-change

Generate the next OpenSpec change artifact using the OpenSpec CLI.

Official
Advanced
linaproailinaproai
147

openspec-propose

Generate proposal, design, and task artifacts via the openspec CLI.

Official
Advanced