openspec-new-change

Bootstrap a new OpenSpec change with a structured workflow.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/HerbertGao/qsl-cardhub --skill openspec-new-change-herbertgao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/HerbertGao/qsl-cardhub/tree/main/.cursor/skills/openspec-new-change
Command: npx skills add https://github.com/HerbertGao/qsl-cardhub --skill openspec-new-change-herbertgao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates starting a new OpenSpec change by guiding users through a structured artifact workflow, enabling consistent scoping and ready-to-build scaffolds for feature work.

Core Features & Use Cases

  • Schema-driven change creation: determine a change name, select a workflow schema, and scaffold the change directory.
  • Progress tracking: view the status of generated artifacts and identify what remains to be created.
  • First artifact guidance: output the initial template for the first artifact, enabling immediate start of implementation.

Quick Start

Use the openspec-cn new change <name> command to begin a new change with a kebab-case name, then check status and retrieve the 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 directory?

To scaffold a new OpenSpec change, use the OpenSpec CLI new change command with a kebab-case name, which creates the structured directory and generates the initial artifact templates for immediate development.

What is a structured change workflow in OpenSpec?

A structured change workflow in OpenSpec is a schema-driven process that guides teams through naming, scaffolding, and tracking artifacts to ensure consistent scoping and ready-to-build feature frameworks.

How do I check the status of generated artifacts during change development?

You can check artifact status by running the OpenSpec CLI status command, which reports on generated artifacts and identifies exactly what templates still need to be created for the current change.

Can I select a specific workflow schema when creating an OpenSpec change?

Yes, OpenSpec change creation supports schema selection, allowing you to choose a specific workflow schema that determines the scaffolding structure and artifact generation sequence for your feature development.

Do I need the OpenSpec CLI installed to bootstrap a new change?

Yes, the OpenSpec CLI is required to bootstrap a new change, as it orchestrates the directory creation, status reporting, and first-artifact template generation throughout the structured workflow.

How do I get the first artifact template after scaffolding an OpenSpec change?

After scaffolding the change directory, the workflow outputs the initial template for the first artifact, providing immediate guidance and instructions to start implementation without manual setup.