skills.rest
thewoolleyman
thewoolleymanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-new-change

Scaffolds a new OpenSpec change directory with artifact workflow instructions.

Updated Jan 31, 2026
Search Tags:#workflow#spec-driven#cli#artifacts#openspec#proposal#change scaffolding
One-click install
npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-new-change-thewoolleyman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/thewoolleyman/personal-knowledge-base/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-new-change-thewoolleyman

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, which is error-prone when done manually. ## Core Features & Use Cases - Change Scaffolding: Runs openspec new change to create a kebab-case change directory under openspec/changes/ with the selected workflow schema. - Artifact Status Inspection: Shows which artifacts are ready or pending via openspec status and retrieves the template for the first artifact. - Use Case: A developer wants to add user authentication to their project. The skill derives the name add-user-auth, scaffolds the change, and presents the proposal template so drafting can begin immediately. ## Quick Start Ask the assistant to start a new OpenSpec change for the feature you want to build, describing it in a sentence.

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 need to be created.

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>`.

What happens after creating an OpenSpec change?▼

The skill shows the artifact status and retrieves instructions for the first ready artifact, such as the proposal template. It stops there 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 you will be prompted to continue that change instead.

Does this skill create the change artifacts automatically?▼

No. It only scaffolds the change directory and displays the first artifact's template and instructions. Guardrails explicitly prevent creating artifacts or advancing beyond showing the first template.

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
081595081595

openspec-onboard

Guide contributors through the OpenSpec workflow for proposing, implementing, and archiving changes.

Community
Intermediate
dallaydallay

sdd-init

Detect project stack and bootstrap openspec directories and configuration.

Official
Intermediate
sgiathsgiath
4

openspec-new-change

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

Community
Intermediate