openspec-new-change

Scaffold OpenSpec changes with artifact-driven workflows and preview templates.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/captaincontrat/audio-recap --skill openspec-new-change-captaincontrat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/captaincontrat/audio-recap/tree/main/.cursor/skills/openspec-new-change
Command: npx skills add https://github.com/captaincontrat/audio-recap --skill openspec-new-change-captaincontrat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec change management often lacks a repeatable, artifact-driven workflow, leading to ad-hoc changes and inconsistent setups.

Core Features & Use Cases

  • Guided change scaffolding: creates a scaffold at openspec/changes/<name> with the selected schema.
  • Workflow awareness: determines default behavior and allows overriding with a specific schema if requested.
  • Artifact-first preview: surfaces the status of artifacts and provides the exact first-artifact template without creating artifacts.
  • Guardrails and collaboration: prompts for user direction to ensure safe and auditable changes.

Quick Start

Describe your desired change to generate the first artifact template without creating anything 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 scaffold a new OpenSpec change with a guided workflow?

Scaffolding a new OpenSpec change creates a directory at openspec/changes/<name> using an artifact-driven workflow. It applies a default schema automatically, but you can override it with a specific workflow if requested.

What is an artifact-driven workflow for change management?

An artifact-driven workflow for change management provides a reproducible, guided process to scaffold changes. It surfaces artifact statuses and generates the first-artifact template without creating artifacts until explicit user direction is given.

How do I preview the first artifact template before creating OpenSpec changes?

You preview the first artifact template by describing your desired change. The tool surfaces artifact statuses and the exact first-artifact template without creating any artifacts, preventing premature file generation until you provide explicit direction.

Can I override the default workflow schema when scaffolding OpenSpec changes?

Yes, you can override the default workflow schema when scaffolding OpenSpec changes. The tool determines the default behavior but allows you to explicitly request and apply a specific schema to suit your change management needs.

Why does my OpenSpec change artifact not get created automatically?

Your OpenSpec change artifact is not created automatically because the tool enforces guardrails for safe, auditable changes. It prompts for user direction and prevents artifact creation until you explicitly provide that direction.

Is OpenSpec change scaffolding suitable for product teams needing reproducible setups?

Yes, OpenSpec change scaffolding is suitable for product teams needing reproducible setups. It replaces ad-hoc change management with a repeatable, artifact-driven process that guides developers through safe and auditable change creation.