openspec-new-change

Automate OpenSpec change scaffolding with artifact-driven workflow steps.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/martinsson/checkin-automation --skill openspec-new-change-martinsson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/martinsson/checkin-automation/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/martinsson/checkin-automation --skill openspec-new-change-martinsson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams bootstrap a new OpenSpec change using an artifact-driven workflow, reducing boilerplate, miscommunication, and setup overhead during feature development or bug fixes.

Core Features & Use Cases

  • Scaffold a new OpenSpec change under openspec/changes/<name>, ready for artifact creation.
  • Automatically determine and apply the appropriate workflow schema, generate initial artifact templates, and enable status and instructions checks.
  • Use case: a software team wants a repeatable process to propose a feature with a clear lifecycle and traceable artifacts, from proposal to ready-to-implement change.

Quick Start

Provide a kebab-case change name to begin scaffolding a new OpenSpec change and review the first artifact template before proceeding.

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 for a feature proposal?

Scaffolding an OpenSpec change requires providing a kebab-case name, which automatically generates the openspec/changes/<name> directory and applies the appropriate workflow schema to generate initial artifact templates for your feature proposal.

What is the artifact-driven workflow used for OpenSpec change management?

The artifact-driven workflow in OpenSpec change management automates change naming, schema selection, and artifact scaffolding to provide a repeatable lifecycle process with traceable artifacts from initial proposal to ready-to-implement status.

Do I need the OpenSpec CLI installed to create new changes and artifacts?

Yes, the OpenSpec CLI is required to use this workflow, as it supports the core steps for creating a new change, checking its status, and retrieving first-artifact instructions during the scaffolding process.

Can I use this artifact workflow for both bug fixes and new features?

Yes, the workflow applies to creating new features, fixes, or modifications within OpenSpec projects, automatically determining and applying the appropriate workflow schema across multiple supported schemas.

How do I check the status of an OpenSpec change after scaffolding?

You check the status of an OpenSpec change using the built-in status step supported by the OpenSpec CLI, which tracks the change lifecycle from initial proposal through artifact creation to a ready-to-implement state.

What are the limitations of the OpenSpec artifact-driven change workflow?

The workflow is limited to OpenSpec projects requiring the OpenSpec CLI, meaning it cannot be used for change management outside the supported schemas and artifact-driven lifecycle structure it scaffolds.