openspec-propose

Generates a complete artifact set of proposal, design, and tasks for a software change.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/mazhewitt/budget-analyser --skill openspec-propose-mazhewitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/mazhewitt/budget-analyser/tree/main/.gemini/skills/openspec-propose
Command: npx skills add https://github.com/mazhewitt/budget-analyser --skill openspec-propose-mazhewitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proposes a new software change and generates a complete artifact set (proposal.md, design.md, tasks.md) in one step, saving time and reducing planning overhead.

Core Features & Use Cases

  • Generates a complete change package including a proposal, design, and task list.
  • Provides a structured, repeatable kickoff for new work items that can be handed to engineering teams.
  • Use Case: A product manager wants a quick, well-scoped plan to pitch a feature to stakeholders and engineering.

Quick Start

Describe the change you want to build and run openspec new change <name> to generate the complete proposal set.

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 complete change proposal for a new software feature?

To generate a change proposal, you need a kebab-case change name and the openspec CLI. Running the proposal command produces a complete artifact set including proposal.md, design.md, and tasks.md in one step.

What is included in a structured software change proposal artifact set?

A structured change proposal artifact set includes proposal.md, design.md, and tasks.md files. These documents provide a repeatable kickoff package covering the pitch, technical design, and implementation task list for engineering teams.

How can I quickly scope a feature request for engineering and stakeholders?

You can quickly scope a feature request by describing the desired change and generating a complete proposal package. This provides a well-structured plan ready to pitch to stakeholders and hand off to engineering teams for alignment.

Do I need the openspec CLI to create design docs and task lists?

Yes, you need the openspec CLI installed to create the design docs and task lists. It requires a kebab-case change name to automatically produce the structured proposal, design, and task artifacts for your project.

What is the best way to reduce planning overhead for new software development tasks?

The best way to reduce planning overhead is generating a complete artifact set in one step. This approach produces a structured proposal, design document, and task list simultaneously, saving time and ensuring rapid scoping during ideation.

Can I use this proposal generation approach for project planning across different development teams?

Yes, you can use this proposal generation approach for project planning across development teams. It enables rapid scoping and alignment during ideation and design phases by producing a structured, repeatable kickoff package for new work items.