openspec-new-change

Scaffold a new OpenSpec change with a kebab-case name and workflow schema.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/atman-33/skills --skill openspec-new-change-atman-33
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/atman-33/skills/tree/main/.github/skills/openspec-new-change
Command: npx skills add https://github.com/atman-33/skills --skill openspec-new-change-atman-33

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a guided workflow to start a new OpenSpec change using the experimental artifact-driven process, ensuring users follow a structured setup instead of ad-hoc changes.

Core Features & Use Cases

  • Structured change initiation: Scaffold a new OpenSpec change with optional schema.
  • Guided workflow steps: Leads you through deriving a kebab-case name, selecting a workflow schema, creating the change directory, checking artifact status, and retrieving first artifact instructions.
  • No artifact creation yet: Provides instructions without generating artifacts, enabling planning and alignment with stakeholders.

Quick Start

Use openspec new change "<name>" to create the change scaffold, then run status using openspec status --change "<name>" and fetch the first artifact instructions with openspec instructions <first-artifact-id> --change "<name>".

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 using the artifact-driven workflow?

To start an OpenSpec change, run `openspec new change "<name>"` to scaffold the directory, then check artifact status with `openspec status --change "<name>"` and fetch instructions with `openspec instructions <first-artifact-id> --change "<name>"`.

What is an artifact-driven workflow for feature development?

An artifact-driven workflow structures feature development by guiding you through sequential artifacts. This skill scaffolds the change directory and retrieves the first artifact instructions to ensure structured setup instead of ad-hoc modifications.

Does the OpenSpec change workflow create artifacts automatically during setup?

No, the OpenSpec change workflow does not create artifacts automatically during setup. It provides CLI instructions to orchestrate the process and retrieve the first artifact guidelines, enabling planning and stakeholder alignment before generation.

Can I use a custom workflow schema when scaffolding an OpenSpec change?

Yes, you can select a specific workflow schema when scaffolding an OpenSpec change. The skill enforces the default workflow schema unless you explicitly request a custom schema during the change initiation process.

Why does my OpenSpec change name need to be kebab-case?

Your OpenSpec change name needs to be kebab-case to ensure consistent directory naming and artifact routing. The skill guides you through deriving a kebab-case name to maintain structured workflow paths.

What is the best way to manage change planning before generating artifacts?

The best way to manage change planning is using the OpenSpec CLI to scaffold changes and check artifact status. This approach provides instructions without generating artifacts, allowing stakeholders to align before development proceeds.