openspec-propose

Generates complete OpenSpec change proposals with design, specs, and task artifacts.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/jonathanlin768/CS2Match-Nakama --skill openspec-propose-jonathanlin768
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/jonathanlin768/CS2Match-Nakama/tree/main/.agents/skills/openspec-propose
Command: npx skills add https://github.com/jonathanlin768/CS2Match-Nakama --skill openspec-propose-jonathanlin768

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing proposal documents, design notes, and task breakdowns. This Skill automates that entire flow through the OpenSpec CLI, producing all required artifacts in one step. ## Core Features & Use Cases - One-Step Change Scaffolding: Creates a change directory via openspec new change and generates proposal.md, design.md, and tasks.md in dependency order. - Schema-Driven Artifact Generation: Reads per-artifact instructions, templates, and rules from the OpenSpec CLI so each document follows the project's specification format. - Dependency-Aware Workflow: Tracks artifact status with openspec status --json and only stops when every artifact required before implementation is complete. - Use Case: Describe "add user authentication" and receive a kebab-case change folder containing a proposal explaining the what and why, a design document covering the how, and a tasks list ready for implementation. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, for example by describing the feature and letting it create the full OpenSpec proposal with design and tasks.

Frequently Asked Questions about openspec-propose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an OpenSpec change proposal from a feature idea?

Describe what you want to build and the skill derives a kebab-case change name, runs openspec new change, then generates proposal.md, design.md, and tasks.md in dependency order using CLI-provided templates.

What artifacts does an OpenSpec proposal include?

A typical change includes proposal.md covering what and why, design.md covering how, and tasks.md listing implementation steps. The exact set is determined by the schema's applyRequires field reported by openspec status.

Does openspec-propose require the OpenSpec CLI installed?

Yes, the skill depends entirely on the openspec command-line tool for scaffolding changes, fetching artifact instructions, and checking status. Install it globally with npm before using the skill.

What happens if a change with the same name already exists?

The skill asks whether you want to continue the existing change or create a new one with a different name, rather than overwriting or failing silently.

When should I not use the one-step propose workflow?

Avoid it when requirements are still highly ambiguous or when you only need a single artifact, since the workflow generates all implementation-required artifacts and works best with a reasonably clear feature description.