openspec-propose

Generate proposal.md, design.md, and tasks.md artifacts from a single change request.

5|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ValorVie/custom-skills --skill openspec-propose-valorvie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/ValorVie/custom-skills/tree/main/project-template/.gemini/skills/openspec-propose
Command: npx skills add https://github.com/ValorVie/custom-skills --skill openspec-propose-valorvie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change by consolidating planning into a single workflow that generates a complete set of artifacts (proposal.md, design.md, tasks.md) and guidance, reducing back-and-forth and accelerating onboarding.

Core Features & Use Cases

  • One-step change proposal and artifact generation for rapid project scoping.
  • Auto-generates proposal, design, and tasks documents from a single input.
  • Use case: a product manager describes a feature change and the system outputs all required planning artifacts for review.

Quick Start

Describe what you want to build and I will generate a complete proposal with artifacts.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I auto-generate proposal, design, and tasks documents for product development?

Auto-generate proposal, design, and tasks documents by describing your feature change in a single input. The workflow outputs proposal.md, design.md, and tasks.md simultaneously, accelerating rapid project scoping from idea to implementation.

What is the best way to automate change-management artifact generation for rapid scoping?

Automate change-management artifact generation by consolidating planning into a single workflow. Inputting your change description triggers the automatic creation of proposal, design, and tasks markdown files, reducing back-and-forth and accelerating onboarding.

Do I need YAML frontmatter to generate planning artifacts for a change proposal?

Yes, you need YAML frontmatter to generate planning artifacts. The structured artifact generation process enforces a YAML frontmatter requirement containing the name and description fields before outputting your proposal, design, and tasks documents.

Can I include optional components like scripts and references when auto-generating design documents?

Yes, you can include optional components like scripts, references, and assets when auto-generating design documents. The structured artifact generation process supports these optional additions alongside the required proposal, design, and tasks files.

How does a single workflow generate all required planning artifacts from one idea?

A single workflow generates all required planning artifacts by taking your idea input and automatically producing proposal.md, design.md, and tasks.md. This consolidated process applies to product development and change-management workflows where rapid scoping is needed.

What limitations exist when using automated proposal generation for complex change-management workflows?

A limitation of automated proposal generation is that it enforces a strict YAML frontmatter requirement with name and description fields. While it supports optional components like scripts and references, complex change-management workflows may require manual review of the generated artifacts.