openspec-propose

Generate proposal.md, design.md, and tasks.md from approved directions.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Miss-PinkElf/Multi-Agent --skill openspec-propose-miss-pinkelf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Miss-PinkElf/Multi-Agent/tree/main/.claude/skills/spark-workflow/skills/openspec-propose
Command: npx skills add https://github.com/Miss-PinkElf/Multi-Agent --skill openspec-propose-miss-pinkelf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After alignment, teams often struggle to formalize decisions into shareable artifacts. This skill converts approved directions into proposal.md, design.md, and tasks.md to streamline handoffs and implementation planning.

Core Features & Use Cases

  • Template-driven generation of proposal.md, design.md, and tasks.md from a confirmed direction.
  • Optional mapping of external specs to corresponding artifacts for traceability.
  • Guardrails to require user approval before moving from draft to implementation.

Quick Start

Create proposal.md, design.md, and tasks.md from the confirmed direction.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate software design and task documentation from an approved proposal?

To generate software design and task documentation from an approved proposal, this skill transforms the confirmed direction into formal artifacts, specifically creating proposal.md, design.md, and tasks.md files.

What is the best way to formalize alignment decisions into development artifacts?

The best way to formalize alignment decisions into development artifacts is using template-driven generation that converts approved directions into proposal.md, design.md, and tasks.md to streamline handoffs and planning.

How do I create tasks.md and design.md files from a confirmed project direction?

You create tasks.md and design.md files from a confirmed project direction by applying this skill after alignment within the SPARK-workflow, which generates the artifacts directly from templates and reference mappings.

Can I map external specs to proposal and design documentation for traceability?

Yes, you can map external specs to proposal and design documentation for traceability, as the skill provides optional mapping of external specifications to their corresponding generated artifacts.

Do I need user approval before moving from draft documentation to implementation?

Yes, you need user approval before moving from draft documentation to implementation, because the skill enforces guardrails that require explicit approval before proceeding to the implementation phase.

When do I need to escalate issues during software proposal and design generation?

You need to escalate issues during software proposal and design generation when the alignment direction is ambiguous or blocked, as the skill provides explicit steps for escalation if approval cannot be reached.