openspec-new-change

Scaffold OpenSpec change directories and retrieve the first artifact template.

4|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/JanuaryLabs/deepagents --skill openspec-new-change-januarylabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/JanuaryLabs/deepagents/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/JanuaryLabs/deepagents --skill openspec-new-change-januarylabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through starting a new OpenSpec change using an artifact-driven workflow, removing uncertainty about naming, schema selection, and the initial artifact to create.

Core Features & Use Cases

  • Guided Change Initialization: Interactively derive a kebab-case change name from the user's description or validate a provided name and create the change scaffold.
  • Schema-aware Workflow Selection: Use the default schema unless the user requests a specific schema, optionally listing available schemas for selection.
  • Artifact-first Guidance: Show artifact status and present the template and context for the first ready artifact without creating any artifacts.
  • Use Case: When adding a new feature or fix to an OpenSpec repository, use this Skill to scaffold the change, inspect which artifacts are required, and obtain the first artifact template to start drafting content.

Quick Start

Start a new change named add-user-auth by describing what you want to build and ask me to scaffold it and show the first artifact template.

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

To scaffold a new OpenSpec change, this Skill initializes the openspec/changes/<name> directory using a validated kebab-case name. It creates the necessary folder structure and prepares the change management workflow.

What is the artifact workflow in OpenSpec change management?

The OpenSpec artifact workflow guides you sequentially through required documents for a change. This Skill checks artifact readiness and retrieves the first artifact template, allowing you to draft content without missing required steps.

Do I need the openspec CLI installed to initialize a change scaffold?

Yes, initializing an OpenSpec change scaffold requires the openspec CLI available in your system PATH. The Skill relies on the CLI to create the change directory and retrieve the default schema templates.

Can I use a non-default schema when creating an OpenSpec change?

Yes, you can use a non-default schema for your OpenSpec change by explicitly requesting it. The Skill uses the default schema automatically but can list available schemas for selection when needed.

How do I get the first artifact template for an OpenSpec modification?

To get the first artifact template for an OpenSpec modification, the Skill evaluates artifact readiness and surfaces the initial template. It provides the context needed to start drafting without creating the artifact automatically.