openspec-new-change

Creates a new OpenSpec change scaffold with artifact workflow guidance.

18|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill openspec-new-change-igamenovoer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/igamenovoer/houmao/tree/main/tests/fixtures/plain-agent-def/skills/openspec-new-change
Command: npx skills add https://github.com/igamenovoer/houmao --skill openspec-new-change-igamenovoer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you start a new OpenSpec feature, fix, or modification without guessing the artifact workflow or skipping critical setup steps.

Core Features & Use Cases

  • Guided change creation: Creates the change scaffold in the correct location using a structured name and optional workflow schema selection.
  • Artifact workflow visibility: Shows which artifacts are already ready and which ones still need to be created.
  • First-artifact instruction generation: Retrieves the template and context for the first ready artifact so you can begin immediately.

Quick Start

Start a new change by telling the AI what you want to build or fix, including a kebab-case change name if you already have one.

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 an OpenSpec change for a new feature or fix?

To scaffold an OpenSpec change, provide the feature or fix details and an optional kebab-case name. The workflow creates the change scaffold in the correct location and generates instructions for the first artifact to begin drafting immediately.

What is an artifact-driven workflow for documentation automation?

An artifact-driven workflow structures documentation automation by tracking which artifacts are ready and which need creation. It retrieves templates and context for the first ready artifact, preventing premature artifact creation while guiding the drafting process step by step.

How do I check which OpenSpec artifacts are ready or still need to be created?

You can check artifact workflow status by running openspec status. This command displays visibility into the artifact workflow, showing which artifacts are already prepared and which ones still require creation before completion.

When should I select a schema during OpenSpec change scaffolding?

You should only select a schema during OpenSpec change scaffolding when explicitly requested or when listing available schemas. The workflow avoids premature artifact creation by deferring schema selection unless specifically needed for the structured setup.

Can I start drafting OpenSpec documentation without guessing the workflow steps?

Yes, you can start drafting without guessing steps. The workflow generates first-artifact instructions with the necessary template and context, allowing you to begin immediately while avoiding premature artifact creation or skipping critical setup.

What's the best way to avoid premature artifact creation when starting a new change?

The best way to avoid premature artifact creation is using an experimental artifact-driven workflow. It scaffolds the change step by step, showing artifact readiness status and only providing instructions for the next ready artifact to prevent skipping setup.