develop-solution-brief — Claude Code skill: one-page solution brief
Turns a problem into a one-page brief: proposed approach, key features, trade-offs and risks. Useful before you write the full spec.
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-codeWhat develop-solution-brief does
The skill walks the agent through seven steps: recap the problem, describe the proposed solution in plain language, list key features, define success metrics, state trade-offs, cover risks with mitigations, and outline next steps. Output follows the template in references/TEMPLATE.md, with every section filled in. A finished example sits in references/EXAMPLE.md.
The one-page limit is the point. Roughly 500–700 words, 3–5 essential features, a problem recap of 2–3 sentences. That constraint is what makes the brief readable for stakeholders who don't want implementation detail.
Pick something else when the approach is already settled. If engineering needs the full specification, use deliver-prd — the brief pitches, the PRD specifies. If the problem itself isn't framed yet, run define-problem-statement first. For a decision already made, the author points to develop-adr or develop-design-rationale. The skill is Apache-2.0, sits in the develop phase and the ideation category, and draws on triple-diamond, lean-startup and design-thinking.
What it helps with
- fit a solution description onto a single page
- align teams on an approach before PRD writing
- record what you deliberately left out of scope
- show leadership the main risks and how you'll handle them
- compare several solution options at a high level
Example prompts for the agent
- write a solution brief for our onboarding problem
- draft a one-page brief: problem, solution, trade-offs, risks
- prepare a solution brief to pitch the approach to stakeholders
How to install develop-solution-brief
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code2Manually: put the files in place
~/.claude/skills/develop-solution-brief/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/develop-solution-brief/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a codex2Manually: put the files in place
.agents/skills/develop-solution-brief/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a cursor2Manually: put the files in place
.cursor/skills/develop-solution-brief/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install product-on-purpose/pm-skills develop-solution-brief2Manually: put the files in place
.github/skills/develop-solution-brief/SKILL.md1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a gemini-cli2Platform CLI
gemini skills install https://github.com/product-on-purpose/pm-skills --path skills/develop-solution-briefManually: put the files in place
.devin/skills/develop-solution-brief/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about develop-solution-brief
How do I install develop-solution-brief in Claude?
Run npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code. The skill file lands at ~/.claude/skills/develop-solution-brief/SKILL.md.
What does develop-solution-brief do?
It produces a one-page document covering the proposed solution: a short problem recap, key features, success metrics, trade-offs considered, risks with mitigations, and next steps.
How is it different from a PRD?
The brief pitches the approach and stays on one page; the spec comes from a separate skill, deliver-prd. If stakeholders already agree and engineers need detail, go with the PRD.
Source text
SKILL.md · Apache-2.0
--- name: develop-solution-brief description: Creates a concise one-page solution overview that communicates the proposed approach, key decisions, and trade-offs. Use when pitching solutions to stakeholders, aligning teams on approach, or documenting solution intent before detailed specification. license: Apache-2.0 metadata: phase: develop version: "2.1.0" updated: 2026-06-10 category: ideation frameworks: [triple-diamond, lean-startup, design-thinking] author: product-on-purpose --- <!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 --> # Solution Brief A solution brief is a concise, one-page document that communicates the proposed solution to a problem. It serves as the bridge between problem understanding and detailed specification, providing enough context for stakeholders to align on the approach without getting lost in implementation details. The one-page constraint forces clarity and prioritization. ## When to Use - Pitching a solution approach to stakeholders for buy-in - Aligning cross-functional teams on what you're building and why - Documenting solution intent before detailed PRD writing - Comparing multiple solution options at a high level - Communicating product direction to leadership ## When NOT to Use - Stakeholders are aligned and engineering needs the full specification -> use `deliver-prd`; the brief pitches, the PRD specifies - The problem is not yet framed or agreed -> use `define-problem-statement` first - You are recording a decision already made -> use `develop-adr` (technical) or `develop-design-rationale` (design) - You need to compare strategic options across the whole business model -> use `foundation-lean-canvas` ## Instructions When asked to create a solution brief, follow these steps: 1. **Recap the Problem** Summarize the problem in 2-3 sentences maximum. Don't re-explain the full problem statement - reference it if needed. The reader should immediately understand what pain point this solution addresses. 2. **Describe the Proposed Solution** Explain what you're building in clear, non-technical language. Focus on the user experience and core value proposition. Avoid implementation details - this is about *what*, not *how*. 3. **List Key Features** Identify 3-5 essential features that comprise the solution. These should be the minimum set needed to solve the problem. Resist the urge to include nice-to-haves - the one-page constraint demands focus. 4. **Define Success Metrics** Connect the solution to measurable outcomes. How will you know if this works? Reference metrics from the problem statement and set targets. 5. **Acknowledge Trade-offs** Document what you're explicitly NOT doing and why. Good solution briefs are honest about scope limitations and alternatives that were considered but rejected. 6. **Identify Risks and Mitigations** Surface the biggest risks to success and your plan to address them. This builds stakeholder confidence and surfaces concerns early. 7. **Outline Next Steps** Provide 3-5 immediate actions to move the solution forward. Be specific about who does what. ## Output Format Use the template in `references/TEMPLATE.md` to structure the output. A complete brief fills every template section: Problem Recap; Proposed Solution; Key Features; Success Metrics; Trade-offs Considered; Risks & Mitigations; and Next Steps. ## Quality Checklist Before finalizing, verify: - [ ] Brief fits on one page when printed (approximately 500-700 words) - [ ] Problem recap is concise (2-3 sentences maximum) - [ ] Solution description avoids technical jargon - [ ] Features are limited to 3-5 essential capabilities - [ ] Trade-offs are explicitly stated - [ ] Next steps are specific and actionable ## Examples See `references/EXAMPLE.md` for a completed example.
© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills