skills.rest
AD-Paladins
AD-PaladinsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sdd-propose

Creates structured SDD change proposals with intent, scope, capabilities, and rollback plans.

Updated Jul 10, 2026
Search Tags:#documentation#sdd#change management#spec-driven development#openspec#proposal#sub-agent
One-click install
npx skills add https://github.com/AD-Paladins/beaconator-web --skill sdd-propose-ad-paladins
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/AD-Paladins/beaconator-web/tree/main/.config/opencode/skills/sdd-propose
Command: npx skills add https://github.com/AD-Paladins/beaconator-web --skill sdd-propose-ad-paladins

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough change idea into a well-structured proposal document is slow and inconsistent. This Skill generates a standardized proposal.md with intent, scope, capabilities, risks, and rollback plans so every spec-driven change starts from the same quality baseline. ## Core Features & Use Cases - Structured Proposal Generation: Produces a proposal.md with Intent, Scope, Capabilities, Approach, Affected Areas, Risks, Rollback Plan, and Success Criteria. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, writing to Engram topics or openspec/changes/ folders as configured. - Interactive Question Rounds: Runs proposal-shaping question rounds to uncover business rules, edge cases, and scope boundaries before finalizing. - Use Case: After exploring a codebase for a new feature like dark mode, the orchestrator delegates to this sub-agent to produce a concise proposal under 450 words that the sdd-spec agent can consume as a contract. ## Quick Start Ask the orchestrator to create an SDD proposal for your change, for example: create a proposal for the add-dark-mode change based on the exploration analysis.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I create an SDD change proposal?▼

Delegate to the sdd-propose sub-agent with a change name and either exploration analysis or a direct description. It generates a proposal.md with intent, scope, capabilities, risks, and rollback plan, then persists it according to your artifact store mode.

What is the difference between engram and openspec persistence modes?▼

Engram mode saves the proposal as an Engram topic like sdd/{change-name}/proposal without touching the filesystem. Openspec mode writes proposal.md into openspec/changes/{change-name}/, while hybrid mode does both.

Can the orchestrator run sdd-propose instructions directly?▼

No. The skill has an orchestrator gate requiring delegation to a dedicated sdd-propose sub-agent via the platform's task or sub-agent primitive. Only the executor sub-agent should run the phase instructions.

Why must the proposal include a Capabilities section?▼

The Capabilities section is the contract between the proposal and specs phases. The sdd-spec agent reads it to know exactly which spec files to create or update, so new and modified capabilities must be listed explicitly.

What are the size limits for an SDD proposal?▼

The proposal artifact must stay under 450 words. It should use bullet points and tables over prose, with headers for organization, keeping it a concise thinking tool rather than lengthy documentation.

Related Skills

Explore More Software Engineering Skills→
Cogni-DAOCogni-DAO

research

Execute a research spike to produce findings and a proposed build layout.

Official
Intermediate
TencentBlueKingTencentBlueKing
840

openspec-sync-specs

Sync delta specs from an OpenSpec change into main specification files.

Official
Intermediate
Arman-KudaibergenovArman-Kudaibergenov
151

openspec-proposal

Formalize requested changes into OpenSpec proposal, tasks, design, and spec delta documents.

Community
Intermediate
2lab-ai2lab-ai
36

spec

Generate a formal feature spec with decision gates and changelog.

Official
Advanced