openspec-new-change

Creates a new OpenSpec change scaffold using the artifact-driven workflow.

5|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/8007342/tillandsias --skill openspec-new-change-8007342
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/8007342/tillandsias/tree/main/.opencode/skills/openspec-new-change
Command: npx skills add https://github.com/8007342/tillandsias --skill openspec-new-change-8007342

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a structured spec-driven change requires knowing the OpenSpec CLI commands, schema selection, and artifact sequencing. This Skill walks through scaffolding a new change correctly so the first artifact template is ready without manual setup errors. ## Core Features & Use Cases - Change Scaffolding: Runs openspec new change with a kebab-case name derived from the user's description, optionally with a custom workflow schema. - Store Awareness: Discovers registered OpenSpec stores via openspec store list --json and applies --store <id> consistently across all subsequent commands. - Artifact Guidance: Shows change status and retrieves the template and instructions for the first artifact without creating it prematurely. - Use Case: A developer says "add user authentication" and the Skill derives the name add-user-auth, scaffolds the change, reports status, and presents the proposal template ready for drafting. ## 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?▼

Provide a change name in kebab-case or describe what you want to build, and the Skill derives a valid name. It then runs `openspec new change` to scaffold the change and shows the status and first artifact instructions.

How do I use a different OpenSpec workflow schema?▼

Mention a specific schema name and the Skill passes `--schema <name>` when creating the 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 and instructions for the first artifact. It explicitly stops and waits for your direction before drafting any artifact content.

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 corrected name.

What is an OpenSpec store and when do I need one?▼

A store is a standalone OpenSpec repository registered on your machine. If your work lives in one, the Skill discovers store ids with `openspec store list --json` and applies `--store <id>` to all read and write commands.