skills.rest
ValorVie
ValorVieCOMMUNITY
Explore all skills by this author →
GitHub

openspec-new-change

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

Updated Jan 5, 2025
Search Tags:#workflow#spec-driven#scaffolding#cli#artifacts#change management#openspec
One-click install
npx skills add https://github.com/ValorVie/settingZsh --skill openspec-new-change-valorvie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/ValorVie/settingZsh/tree/main/.gemini/skills/openspec-new-change
Command: npx skills add https://github.com/ValorVie/settingZsh --skill openspec-new-change-valorvie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a structured spec-driven change requires knowing the correct OpenSpec CLI commands, schema selection, and artifact ordering. This Skill guides the AI through scaffolding a new change directory and surfacing the first artifact's instructions without skipping steps. ## Core Features & Use Cases - Change Scaffolding: Runs openspec new change with a validated kebab-case name to create the change directory under openspec/changes/. - Workflow Schema Selection: Uses the default schema by default, or a user-specified schema via --schema, with discovery through openspec schemas --json. - Artifact Status & Instructions: Shows artifact readiness via openspec status and retrieves the template for the first ready 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 0/N artifact status, and presents the proposal template 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?▼

Run `openspec new change "<name>"` with a kebab-case name to scaffold a change directory under `openspec/changes/`. Then use `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. If you need a different schema, run `openspec schemas --json` to list available workflows, then pass the chosen one with `--schema <name>` when creating the change.

What naming format does OpenSpec require for changes?▼

Change names must be kebab-case, such as `add-user-auth`. If a description is provided instead, derive a kebab-case name from it before running the scaffold command.

What happens if an OpenSpec change name already exists?▼

The scaffold command will fail because the change directory already exists. Instead of creating a duplicate, continue working on the existing change by checking its status and artifact progress.

Does this Skill create the change artifacts automatically?▼

No. It only scaffolds the change, shows artifact status, and displays the first artifact's template and instructions. It explicitly stops and waits for user direction before drafting any artifact content.

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
rpamisrpamis
2.9k

openspec-ff-change

Generates all OpenSpec change artifacts in one pass until implementation-ready.

Official
Intermediate
dallaydallay

sdd-init

Detect project stack and bootstrap openspec directories and configuration.

Official
Intermediate
pabloimrik17pabloimrik17

openspec-ff-change

Automate creation of OpenSpec change artifacts within CLI workflows.

Community
Intermediate