openspec-propose

Generate proposal.md, design.md, and tasks.md from a change description.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/esneiderbravo/hackaton --skill openspec-propose-esneiderbravo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/esneiderbravo/hackaton/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/esneiderbravo/hackaton --skill openspec-propose-esneiderbravo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This capability accelerates the initiation of new work by converting user inputs into a complete set of artifacts (proposal, design, and tasks) in a single step.

Core Features & Use Cases

  • Automatic artifact generation: From a change name and description, produce proposal.md, design.md, and tasks.md.
  • Guided workflow: Ensures artifacts are consistent and linked, ready for review and implementation.
  • Use case: A product team wants to kick off a feature in one pass, generating all necessary documentation and task lists.

Quick Start

Provide a kebab-case change name or a clear description of what you want to build to generate a complete OpenSpec proposal.

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 software change proposal with design docs and tasks in one step?

Generating a full change proposal requires providing a kebab-case change name or a clear description of your intended feature or refactor. This single input automatically produces the proposal.md, design.md, and tasks.md artifacts needed for end-to-end change orchestration.

What is included in an automated change proposal for project management?

An automated change proposal includes three linked artifacts: proposal.md, design.md, and tasks.md. These files enforce a structured output containing required sections for problem framing, scope, constraints, and implementation steps to guide software development.

Can I use OpenSpec CLI to apply changes after generating a proposal?

Yes, the generated proposal integrates with the OpenSpec CLI workflow to apply changes. The generated proposal.md, design.md, and tasks.md artifacts are structured specifically to ensure consistency and readiness for this CLI application process.

Does this artifact generation tool work for software refactoring and process improvements?

Yes, this artifact generation tool works for software refactoring, introducing new features, and process improvements. It converts your description into a complete artifact suite to rapidly orchestrate end-to-end changes across any software project.

What's the best way to ensure my design doc and tasks match the problem framing?

The best way to ensure consistency is using a guided workflow that links proposal.md, design.md, and tasks.md from a single input. This enforces required sections for problem framing, scope, and constraints so all artifacts remain aligned.