wilberhernan/opencode-will/sdd-propose
Claude Code and agent skill by wilberhernan/opencode-will
- community
Checking that the SKILL.md file is still in the repository.
Create an SDD change proposal with intent, scope, and approach. Trigger: orchestrator launches proposal work for a change.
Install
npx vskill@latest install wilberhernan/opencode-will/sdd-proposeSKILL.md
The same SKILL.md was published earlier as wilberhernan/opencode-will/sdd-propose.
ORCHESTRATOR GATE: If you loaded this skill via theskill()tool, you arethe ORCHESTRATOR — STOP. Do NOT execute these instructions inline. Delegate tothe dedicatedsdd-proposesub-agent using your platform's delegation primitive(e.g.,task(...), sub-agent invocation, etc.). This skill is for EXECUTORSonly.
Purpose
You are a sub-agent responsible for creating PROPOSALS. You take the exploration analysis (or direct user input) and produce a structured proposal.md document inside the change folder.
What You Receive
From the orchestrator:
- Change name (e.g., "add-dark-mode")
- Exploration analysis (from sdd-explore) OR direct user description
- Artifact store mode (
engram | openspec | hybrid | none)
Execution and Persistence Contract
Follow Section B (retrieval) and Section C (persistence) fromskills/_shared/sdd-phase-common.md.
- engram: Read
sdd/{change-name}/explore(optional) andsdd-init/{project}(optional). Save artifact assdd/{change-name}/proposal. - openspec: Read and follow
skills/_shared/openspec-convention.md. - hybrid: Follow BOTH conventions — persist to Engram AND write to filesystem. Retrieve dependencies from Engram (primary) with filesystem fallback.
- none: Return result only. Never create or modify project files.
- Never force
openspec/creation unless user requested file-based persistence or mode ishybrid.
What to Do
Step 1: Load Skills
Follow Section A from skills/_shared/sdd-phase-common.md.
Step 2: Create Change Directory
IF mode is `openspec` or `hybrid`: create the change folder structure:
IF mode is `engram` or `none`: Do NOT create any openspec/ directories. Skip this step.
Step 3: Read Existing Specs
IF mode is `openspec` or `hybrid`: If openspec/specs/ has relevant specs, read them to understand current behavior that this change might affect.
IF mode is `engram`: Existing context was already retrieved from Engram in the Persistence Contract. Skip filesystem reads.
IF mode is `none`: Skip — no existing specs to read.
Step 4: Write proposal.md
Step 5: Persist Artifact
This step is MANDATORY — do NOT skip it.
Follow Section C from skills/_shared/sdd-phase-common.md.
- artifact:
proposal - topic_key:
sdd/{change-name}/proposal - type:
architecture
Step 6: Return Summary
Return to the orchestrator:
Rules
- In
openspecmode, ALWAYS create theproposal.mdfile - If the change directory already exists with a proposal, READ it first and UPDATE it
- Keep the proposal CONCISE - it's a thinking tool, not a novel
- Every proposal MUST have a rollback plan
- Every proposal MUST have success criteria
- Use concrete file paths in "Affected Areas" when possible
- Apply any
rules.proposalfromopenspec/config.yaml - ALWAYS fill in the Capabilities section — this is the contract with sdd-spec. Research
openspec/specs/first to use correct existing capability names. - New Capabilities → each will become
openspec/specs/<name>/spec.md(new full spec) - Modified Capabilities → each will become a delta spec in the change folder
- If nothing changes at the spec level (pure refactor, config change), explicitly write "None" under both sub-sections — don't leave them as template placeholders
- Size budget: Proposal artifact MUST be under 450 words. Use bullet points and tables over prose. Headers organize, not explain.
- Return envelope per Section D from
skills/_shared/sdd-phase-common.md.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/sdd-propose/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/wilberhernan/opencode-will/sdd-propose)