skills.rest
HerbertGao
HerbertGaoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-propose

Generate proposal, design, and task artifacts from a change concept using openspec-cn workflows.

1|Updated Jul 25, 2025
Search Tags:#specification#architecture design#task planning#requirements clarification#change proposal#openspec-cn
One-click install
npx skills add https://github.com/HerbertGao/x_likes_downloader --skill openspec-propose-herbertgao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/HerbertGao/x_likes_downloader/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/HerbertGao/x_likes_downloader --skill openspec-propose-herbertgao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you want to propose a software change but need a complete, implementation-ready package, this Skill helps you go from a raw description to structured proposal, design, and task outputs in one workflow.

Core Features & Use Cases

  • One-step change proposal generation: Creates a new change and generates all required artifacts (proposal.md, design.md, tasks.md) so you can move toward implementation faster.
  • Dependency-ordered artifact building: Reads the required build order from openspec-cn status and produces outputs only when dependencies are satisfied.
  • Interactive clarification when context is unclear: Uses user questions to resolve missing requirements before generating deliverables.
  • Use case: You describe a feature or fix you want to build, and the Skill outputs a full proposal + design + implementation task plan to prepare for applying the change.

Quick Start

Ask the AI to propose your change by describing what you want to build or fix, and include a change name in kebab-case if you have one.

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 from a feature idea?▼

To generate a change proposal from a feature idea, describe the change concept to the AI. The Skill creates an openspec-cn change directory and outputs implementation-ready proposal.md, design.md, and tasks.md artifacts.

What is included in a change proposal package?▼

A change proposal package includes proposal, design, and task artifacts. The Skill derives the build order from openspec-cn status JSON and generates these deliverables sequentially as dependencies are satisfied.

Do I need openspec-cn installed to create task planning artifacts?▼

Yes, openspec-cn is required to create task planning artifacts. The Skill uses openspec-cn scaffolding to create the change directory and reads status JSON to determine the dependency-ordered artifact generation sequence.

Can I clarify requirements before generating architecture design artifacts?▼

Yes, you can clarify requirements before generating architecture design artifacts. The Skill interactively asks questions to resolve missing information and context gaps before producing the final proposal, design, and task outputs.

What's the best way to prepare a software change proposal for implementation?▼

The best way to prepare a software change proposal for implementation is to describe your desired change in kebab-case. The Skill then builds a complete, structured package of proposal, design, and task plans ready for the /opsx:apply command.

Related Skills

Explore More Product & Management Skills→
brainsnorkelbrainsnorkel

openspec-ff-change

Generate OpenSpec change artifacts in dependency order from a kebab-case name.

Community
Advanced
garethbaumgartgarethbaumgart
1

openspec-propose

Generate proposal.md, design.md, and tasks.md artifacts for a software change.

Community
Advanced
igamenovoerigamenovoer
18

openspec-ff-change

Generate OpenSpec artifacts in dependency order until apply-ready.

Community
Intermediate
whatevertogowhatevertogo

openspec-explore

Explores codebases and drafts OpenSpec proposals without writing implementation code.

Community
Intermediate