openspec-propose

Generate proposal, design, and task artifacts from a change description.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/Valynt/ValueOS --skill openspec-propose-valynt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Valynt/ValueOS/tree/main/.windsurf/skills/openspec-propose
Command: npx skills add https://github.com/Valynt/ValueOS --skill openspec-propose-valynt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change and generate all required artifacts in a single, streamlined workflow, eliminating manual drafting of proposals, designs, and task lists.

Core Features & Use Cases

  • Automatically scaffold proposal.md, design.md, and tasks.md from a user description.
  • Enforce a standardized structure for change proposals to accelerate review and implementation.
  • Useful across product, engineering, and project-management contexts to rapidly align stakeholders on scope and plan.

Quick Start

Describe the desired change and run openspec new change <name> to generate the complete proposal, design, and task artifacts.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate a change proposal and all required artifacts in one step?

To generate a change proposal in one step, describe the desired change and run the command to automatically scaffold proposal.md, design.md, and tasks.md files from your input.

What's the best way to standardize change proposals for engineering teams?

Standardizing change proposals is done by automatically scaffolding proposal.md, design.md, and tasks.md from a user description, enforcing a standardized structure to accelerate review and implementation.

Can I automatically outline scope, design, and tasks from a text description?

Yes, you can outline scope, design, and tasks by providing a text description of the desired change, which the tool uses to automatically scaffold the complete proposal, design, and task artifacts.

Do I need OpenSpec tooling to create change management artifacts?

Yes, OpenSpec tooling is required to create change management artifacts, as the workflow relies on it to generate the required proposal, design, and task files from user input.

Why manually draft a design document when proposing a new change?

Manually drafting a design document is unnecessary because the workflow automatically scaffolds proposal.md, design.md, and tasks.md from a user description, eliminating manual drafting of proposals, designs, and task lists.

When do I need to scaffold proposal, design, and tasks files for a new change?

You need to scaffold proposal, design, and tasks files when you want to rapidly align stakeholders on scope and plan for a new change across product, engineering, and project-management contexts.