skills.rest
Miftah-Fentaw
Miftah-FentawCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-new-change

Scaffold a new OpenSpec change and display the first artifact template.

1|Updated Aug 13, 2026
Search Tags:#workflow#spec-driven#scaffolding#cli#artifacts#change management#OpenSpec
One-click install
npx skills add https://github.com/Miftah-Fentaw/GymPulse --skill openspec-new-change-miftah-fentaw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/Miftah-Fentaw/GymPulse/tree/main/.qwen/skills/openspec-new-change
Command: npx skills add https://github.com/Miftah-Fentaw/GymPulse --skill openspec-new-change-miftah-fentaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a structured spec-driven change requires knowing the OpenSpec CLI workflow, artifact sequence, and store scoping rules. This Skill walks through creating a new change directory, resolving the correct store, and surfacing the first artifact's instructions without prematurely generating content. ## 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-Aware Commands: Discovers registered stores via openspec store list --json and applies a sticky --store <id> flag to all scoped commands. - Artifact Guidance: Shows status JSON and fetches the template for the first ready artifact, then stops for user direction. - Use Case: A developer says "add user authentication" and the Skill creates the add-user-auth change, reports 0/N artifact 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 kebab-case name or describe what you want to build, and the Skill derives a name like add-user-auth. It runs openspec new change to scaffold the change, then shows status and the first artifact's instructions.

How to use a custom workflow schema in OpenSpec?▼

Pass --schema <name> only when the user explicitly requests a specific workflow. Running openspec schemas --json lists available workflows; otherwise the default schema is used by omitting the flag.

Does OpenSpec support multiple stores or repositories?▼

Yes, registered stores are discovered with openspec store list --json. Once a store is selected, the --store <id> flag is applied to all commands that read or write specs and changes for the rest of the workflow.

What happens if the change name is not kebab-case?▼

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

Does this Skill create the proposal artifact automatically?▼

No, it stops after displaying the first artifact's template and instructions. Guardrails explicitly prevent creating artifacts or advancing the workflow until the user provides direction.

Related Skills

Explore More Software Engineering Skills→
germainlefebvre4germainlefebvre4

openspec-new-change

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

Community
Intermediate
DarkHighnessDarkHighness
11

openspec-onboard

Guide users through the OpenSpec workflow from exploration to archival.

Community
Advanced
dallaydallay

sdd-init

Detect project stack and bootstrap openspec directories and configuration.

Official
Intermediate
ondataondata
9

openspec-new-change

Initialize a new OpenSpec change with an artifact-driven workflow scaffold.

Official
Advanced