openspec-new-change

Create an OpenSpec change scaffold with status and first-artifact instructions.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/mazhewitt/budget-analyser --skill openspec-new-change-mazhewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/mazhewitt/budget-analyser/tree/main/.gemini/skills/openspec-new-change
Command: npx skills add https://github.com/mazhewitt/budget-analyser --skill openspec-new-change-mazhewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams starting OpenSpec changes often encounter inconsistent scaffolds and unclear steps. This Skill provides a consistent, artifact-driven workflow to initialize a new change with a defined structure and guardrails.

Core Features & Use Cases

  • Scaffold a new OpenSpec change at openspec/changes/<name> with a chosen or default schema
  • Show status and provide first-artifact instructions without creating anything yet
  • Validate the change name (kebab-case) and suggest continuation if a change already exists
  • Works for feature additions, fixes, or modifications across OpenSpec projects

Quick Start

Run openspec new change "openspec-new-change" to create a scaffold and then review the status and first-artifact instructions.

Frequently Asked Questions about openspec-new-change

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new OpenSpec change for a feature or fix?

To scaffold an OpenSpec change, run the new change command to create a structured directory at openspec/changes/<name>. This initializes the change with a chosen or default schema, providing status reporting and first-artifact instructions without creating artifacts yet.

What is the artifact-driven workflow for OpenSpec change management?

The OpenSpec artifact workflow provides a consistent, repeatable setup to initialize changes with defined structures and guardrails. It offers scaffold creation, status reporting, and first-artifact instructions to ensure teams follow clear steps without inconsistent setups.

Does the OpenSpec change scaffold validate the change name format?

Yes, the OpenSpec change scaffold validates the change name to ensure it uses kebab-case formatting. If a change with that name already exists, it suggests continuation and provides status reporting instead of overwriting the existing scaffold.

Can I use the OpenSpec scaffolding workflow for modifications to existing projects?

Yes, the OpenSpec scaffolding workflow works for feature additions, fixes, or modifications across OpenSpec projects. It creates a structured scaffold at openspec/changes/<name> applicable to any software team needing a repeatable change setup.

Why does the OpenSpec scaffold only provide first-artifact instructions without creating them?

The OpenSpec scaffold provides first-artifact instructions without performing artifact creation to maintain a clear separation between setup and execution. This ensures teams review the status and structure before committing to the actual artifact workflow steps.