openspec-new-change

Create scaffolded OpenSpec changes with kebab-case validation and artifact instructions.

54|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-new-change-mrclrchtr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/mrclrchtr/SuPi/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-new-change-mrclrchtr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users start and organize a new OpenSpec change by guiding name selection, workflow schema choice, and surfacing the first artifact's instructions while preventing premature artifact creation.

Core Features & Use Cases

  • Guided Naming and Validation: Derives or validates a kebab-case change name and prompts for clarification when input is unclear.
  • Schema and Workflow Selection: Uses the default schema unless a specific schema is requested and can list available schemas for user choice.
  • Artifact Status and Instructions: Runs status checks to identify ready artifacts and retrieves the template and context for the first artifact without creating artifacts or advancing the workflow.
  • Use Case: A developer or spec author proposing a new feature can initialize the change scaffold, inspect which artifacts are required, and obtain the first artifact template to begin drafting.

Quick Start

Start a new OpenSpec change named add-user-auth and show the first artifact's 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 from a descriptive feature request?

To scaffold a new OpenSpec change, you provide a descriptive request or name. The tool validates the input as kebab-case, creates the change directory, inspects artifact status, and retrieves the first artifact instructions.

What is the naming validation format required for creating an OpenSpec change?

OpenSpec change names require kebab-case validation. If your input is unclear or improperly formatted, the system prompts for clarification to ensure valid name generation before proceeding.

Does the OpenSpec scaffold process create artifacts automatically when starting a new change?

No, the OpenSpec scaffold process does not create artifacts automatically. It retrieves the template and context for the first artifact without creating artifacts or advancing the workflow.

How do I select a specific workflow schema when initiating an OpenSpec change?

When initiating an OpenSpec change, you can select a specific workflow schema using the optional --schema flag. Without a specific request, it applies the default schema or lists available schemas for choice.

Do I need the openspec CLI installed to scaffold change directories and inspect status?

Yes, the openspec CLI is required. The scaffolding process depends on the openspec CLI to enforce name validation, handle schema selection, inspect artifact status, and retrieve instructions.