openspec-new-change

Scaffold OpenSpec changes with kebab-case naming and artifact instructions.

2|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/Yi-ming-Zhao/Fittin --skill openspec-new-change-yi-ming-zhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/Yi-ming-Zhao/Fittin/tree/main/.cursor/skills/openspec-new-change
Command: npx skills add https://github.com/Yi-ming-Zhao/Fittin --skill openspec-new-change-yi-ming-zhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams initiate a new OpenSpec change using the experimental artifact-driven workflow, providing a guided scaffold for features, fixes, or modifications.

Core Features & Use Cases

  • Guides users to derive a kebab-case change name from a user description
  • Creates a scaffolded change directory at openspec/changes/<name>/ with the selected workflow
  • Guides artifact status checks and reveals first-artifact instructions, stopping for user direction when needed
  • Enforces a default workflow unless a specific schema is requested, and clarifies steps to complete the change

Quick Start

Describe what you want to build to begin creating a new OpenSpec change scaffold.

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 directory?

To scaffold an OpenSpec change, provide a description of your intended modification. The workflow derives a kebab-case name and creates a structured change directory at openspec/changes/<name>/ using the selected schema.

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

The artifact-driven workflow is an experimental approach that guides users through structured steps. It scaffolds the change directory, checks artifact status, retrieves first-artifact instructions, and pauses for user direction before proceeding.

How do I start a new feature or fix workflow using OpenSpec?

Describe what you want to build to initiate the workflow. The system enforces a default schema unless a specific one is requested, scaffolds the necessary directories, and clarifies the steps required to complete the change.

Can I choose a specific schema for my OpenSpec change?

Yes, you can request a specific schema for your OpenSpec change. If no schema is specified, the workflow enforces a default schema to standardize the artifact creation process across your changes.

Why does the OpenSpec workflow pause after showing the first artifact?

The workflow pauses to enforce waiting for user direction after presenting the first artifact. This prevents creating subsequent artifacts until you are ready, ensuring deliberate control over the change progression.