skills.rest
dallay
dallayOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sdd-propose

Create structured proposal.md files for openspec-managed software changes.

Updated Apr 14, 2026
Search Tags:#documentation#rollback#sdd#risk-assessment#openspec#proposal#change-proposal
One-click install
npx skills add https://github.com/dallay/opencode-docker --skill sdd-propose-dallay
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/dallay/opencode-docker/tree/main/config/skills/sdd/sdd-propose
Command: npx skills add https://github.com/dallay/opencode-docker --skill sdd-propose-dallay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams quickly produce clear, structured change proposals so decisions can be made and work can be scoped without lengthy back-and-forth or ambiguous requirements.

Core Features & Use Cases

  • Proposal generation: Create a proposal.md in the change folder with intent, scope, approach, affected areas, risks, rollback plan, dependencies, and success criteria.
  • Existing spec awareness: Read relevant specs in openspec/specs to avoid regressions and align with current behavior.
  • Update or create: Detect an existing proposal and update it, or create a new concise proposal when none exists.
  • Use Case: When an orchestrator passes a change name and exploration analysis, produce a ready proposal for review and next-step workflows (sdd-spec, sdd-design).

Quick Start

Create a proposal for change "add-dark-mode" using the exploration analysis and save it to openspec/changes/add-dark-mode/proposal.md.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I write a change proposal for an OpenSpec-managed project?▼

A software change proposal should include intent, scope, approach, affected areas, risks, rollback plan, dependencies, and success criteria. This Skill generates a structured proposal.md covering all these sections to ensure decisions can be made without ambiguous requirements.

How do I create a proposal document that includes a rollback plan and risk assessment?▼

Yes, existing OpenSpec specifications are read during proposal generation to avoid regressions and align with current behavior. This ensures the new change proposal accounts for established system specs before finalizing the approach.

Can I update an existing proposal if I regenerate the change document?▼

This proposal generator is specifically designed for openspec-managed projects where the orchestrator provides a change name and exploration analysis. It produces a ready proposal for review and downstream SDD workflows like sdd-spec and sdd-design.

What is the best way to structure software change proposals for quick scoping?▼

You need to provide a change name and either exploration analysis or a direct user description. The Skill uses these inputs to generate the proposal.md file in the correct openspec/changes/{change-name}/ directory following openspec conventions.

Related Skills

Explore More Software Engineering Skills→
tiagofurtiagofur

sdd-propose

Generate structured change proposals with standardized sections to proposal.md.

Community
Intermediate
kurojskurojs
2

sdd-onboard

Guides users through an SDD onboarding cycle on their actual codebase to implement a small, safe improvement.

Community
Advanced
mrp4stenmrp4sten
3

sdd-propose

Generate openspec change proposals with Intent, Scope, Approach, and Risks.

Community
Intermediate
josemartinrodriguezmortalonijosemartinrodriguezmortaloni

sdd-propose

Generates structured Markdown change proposals for Spec-Driven Development workflows.

Community
Intermediate