skills.rest
TranVanTienDat
TranVanTienDatCOMMUNITY
Explore all skills by this author →
GitHub

openspec-propose

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

Updated Mar 26, 2026
Search Tags:#spec-driven development#openspec#task generation#design documents#change proposal#cli workflow
One-click install
npx skills add https://github.com/TranVanTienDat/Milkyway --skill openspec-propose-tranvantiendat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/TranVanTienDat/Milkyway/tree/main/agent-core/.cursor/skills/openspec-propose
Command: npx skills add https://github.com/TranVanTienDat/Milkyway --skill openspec-propose-tranvantiendat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal with design documents, specifications, and implementation tasks is slow and inconsistent. This Skill automates the entire OpenSpec proposal workflow so a single description of what you want to build produces all required artifacts in one step. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change directory and generates proposal.md, design.md, and tasks.md in dependency order using the openspec CLI. - Schema-Driven Artifacts: Reads per-artifact instructions, templates, and dependency rules from openspec instructions so every file follows the project schema. - Interactive Clarification: Asks open-ended questions when the change intent is unclear and derives kebab-case change names automatically. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with proposal, design, and tasks ready for implementation via /opsx:apply. ## Quick Start Ask the assistant to propose a new change for adding user authentication and generate all OpenSpec artifacts.

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?▼

Describe what you want to build and the skill runs openspec new change to scaffold the change, then generates proposal.md, design.md, and tasks.md in dependency order. Run /opsx:apply afterward to start implementation.

What artifacts does an OpenSpec proposal include?▼

A proposal typically 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?▼

Yes, the skill depends on the openspec CLI being installed. It calls openspec new, openspec status, and openspec instructions to scaffold changes and retrieve artifact templates and dependency rules.

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. It does not overwrite or merge existing change directories automatically.

Why are context and rules blocks not copied into generated artifacts?▼

The context and rules fields from openspec instructions are constraints guiding the AI's writing, not file content. Copying them into artifacts would pollute the proposal with internal scaffolding metadata.

Related Skills

Explore More Software Engineering Skills→
tnunamaktnunamak

openspec-bootstrap

Initialize OpenSpec for spec-driven development in uninitialized repositories.

Community
Basic
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
Arman-KudaibergenovArman-Kudaibergenov
151

openspec-proposal

Formalize requested changes into OpenSpec proposal, tasks, design, and spec delta documents.

Community
Intermediate
beliciobcardosobeliciobcardoso

openspec-continue-change

Creates the next artifact in an OpenSpec change workflow using the openspec CLI.

Community
Intermediate