openspec-new-change

Scaffold an OpenSpec change directory and surface initial artifact instructions.

11|3|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/DarkHighness/coi-public --skill openspec-new-change-darkhighness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/DarkHighness/coi-public/tree/main/.gemini/skills/openspec-new-change
Command: npx skills add https://github.com/DarkHighness/coi-public --skill openspec-new-change-darkhighness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a guided, repeatable process to initiate a new OpenSpec change using the experimental artifact workflow, ensuring a clean scaffold for feature work or fixes.

Core Features & Use Cases

  • Scaffolds a new OpenSpec change directory and outlines the initial artifact plan.
  • Validates a kebab-case change name, determines the workflow, and surfaces the first artifact instructions without creating artifacts.
  • Provides a stop-and-wait prompt for user direction and iteration, reducing miscommunication and rework.

Quick Start

Provide a kebab-case change name and I will guide you through scaffolding and surfacing the first artifact instructions without creating artifacts yet.

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 structured OpenSpec change workflow for a new feature?

To start an OpenSpec change, you provide a kebab-case name and the Skill scaffolds a change directory while surfacing the first artifact plan instructions without creating artifacts.

What is the artifact-driven process for planning software changes?

The artifact-driven process is an experimental workflow that scaffolds a dedicated change directory and outlines an initial artifact plan to guide feature, fix, or modification work systematically.

Do I need the OpenSpec CLI to scaffold a new change directory?

Yes, the OpenSpec CLI is required to scaffold a new change directory, as the workflow follows defined CLI steps to validate the kebab-case name and prepare the initial artifact plan.

How do I validate a kebab-case name for an OpenSpec change?

Validating a kebab-case name for an OpenSpec change is handled automatically by the workflow, which checks the provided name format before deciding on a schema and scaffolding the directory.

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

No, the OpenSpec scaffold does not create artifacts automatically; it prepares the directory and surfaces the first artifact instructions, then uses a stop-and-wait prompt for your direction.

When should I use an artifact-driven workflow for software fixes?

You should use the artifact-driven workflow for software fixes when you need a guided, repeatable process to ensure a clean scaffold, reducing miscommunication and rework during planning.