openspec-propose

Generate proposal, design, and task artifacts via the openspec CLI.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/benjaminkitt/mindful-engineer --skill openspec-propose-benjaminkitt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/benjaminkitt/mindful-engineer/tree/main/.codex/skills/openspec-propose
Command: npx skills add https://github.com/benjaminkitt/mindful-engineer --skill openspec-propose-benjaminkitt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speed up project initialization by generating a complete proposal (proposal.md, design.md, and tasks.md) for a new change in one step.

Core Features & Use Cases

  • Single-command proposal generation: creates proposal.md, design.md, and tasks.md for a new change.
  • Input-driven naming: derives a kebab-case change name from user description.
  • End-to-end artifact orchestration: coordinates creation, dependencies, and readiness checks for implementation.

Quick Start

Describe the change you want to build and run the openspec new change command to generate all artifacts in one step.

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 with design and task lists in one step?

To generate a complete change proposal in one step, describe your desired change and run the openspec new change command. This automatically creates proposal.md, design.md, and tasks.md artifacts simultaneously. It streamlines project initiation by translating your input into a complete, implementation-ready artifact set.

What is included in the artifact set when I create a new change proposal?

A new change proposal includes proposal.md, design.md, and tasks.md. This complete artifact set streamlines project initialization by translating user input into structured design documentation and task planning files, preparing them for immediate implementation.

Do I need the openspec CLI to manage artifact generation and dependency validation?

Yes, you need the openspec CLI to manage artifact generation and dependency validation. The Skill relies on the openspec CLI to orchestrate end-to-end creation, coordinate dependencies, and perform readiness checks for implementation.

Can I derive a kebab-case change name automatically from my project description?

Yes, you can derive a kebab-case change name automatically. The Skill uses input-driven naming to derive a kebab-case change name directly from your user description when generating the proposal artifacts.

What's the best way to streamline project initiation for a new change management task?

The best way to streamline project initiation for change management is using the openspec new change command. It translates your input into a complete set of proposal, design, and task artifacts in a single step, preparing them for implementation.

When should I use single-command proposal generation instead of creating individual documents?

Use single-command proposal generation when you need to speed up project initialization by creating proposal.md, design.md, and tasks.md together. This approach ensures consistency across artifacts and coordinates dependencies and readiness checks for implementation.