openspec-new-change

Scaffold OpenSpec change directories with kebab-case naming and workflow schemas.

47|2|Updated Oct 30, 2023
One-click install
npx skills add https://github.com/runtime-env/runtime-env --skill openspec-new-change-runtime-env
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/runtime-env/runtime-env/tree/main/.gemini/skills/openspec-new-change
Command: npx skills add https://github.com/runtime-env/runtime-env --skill openspec-new-change-runtime-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines initiating OpenSpec changes by providing a guided, artifact-driven workflow that standardizes setup and context.

Core Features & Use Cases

  • Scaffold a new change directory openspec/changes/<name> with kebab-case naming.
  • Determine and apply the default or requested workflow schema.
  • Show artifact status and provide instructions for the first artifact.
  • Stop and wait for user direction, without creating artifacts yet.

Quick Start

Open a new change scaffold with openspec new change "<name>". Check progress with openspec status --change "<name>". Retrieve 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 scaffold a new change directory in OpenSpec?▼

Scaffold a new OpenSpec change directory by running the CLI command `openspec new change "<name>"`, which creates the change folder under `openspec/changes/` using kebab-case naming.

What is the OpenSpec change workflow for starting new features?▼

The OpenSpec change workflow is an artifact-driven process that standardizes setup by validating names, selecting schemas, generating scaffolds, and providing first-artifact instructions to guide feature modifications safely.

How do I check the status of an OpenSpec change?▼

Check OpenSpec change status using the command `openspec status --change "<name>"`, which displays the current artifact progression and scaffold state for the specified change.

Can I use spaces or uppercase letters when naming an OpenSpec change?▼

No, OpenSpec change naming enforces strict kebab-case formatting, meaning names must be lowercase and use hyphens instead of spaces or underscores to pass validation.

Does the OpenSpec scaffold automatically generate artifacts for my change?▼

No, the scaffold generation stops and waits for user direction without creating artifacts, ensuring safe stepwise progression before preparing any artifact templates.

How do I fetch instructions for the first artifact in an OpenSpec change?▼

Retrieve first artifact instructions by running `openspec instructions <first-artifact-id> --change "<name>"`, which provides the guidance needed to proceed with the workflow.