Skip to content
alyn
product-on-purpose

Develop Solution Brief skill

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.

$npx skills add product-on-purpose/pm-skills --skill develop-solution-brief
View this skill on GitHubproduct-on-purpose/pm-skills/skills/develop-solution-brief/SKILL.md
Pack stars
796
Pack installs
51k
Alyn Score
61/99
Updated
24 h ago
License
Apache-2.0
– views – installs via Alyn

product-on-purpose

Develop Solution Brief

Install Develop Solution Brief

Pick your agent. Every command is ready to paste.

$npx skills add product-on-purpose/pm-skills --skill develop-solution-brief

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads develop-solution-brief when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the develop-solution-brief skill”. In Codex, type $develop-solution-brief.

The skill itself

SKILL.md

FolderGitHub

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.

Tips for Develop Solution Brief

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
  • • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Develop Solution Brief

What does the Develop Solution Brief skill do?

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.

How do I install Develop Solution Brief?

Run "npx skills add product-on-purpose/pm-skills --skill develop-solution-brief" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Develop Solution Brief work in Cursor and Codex?

Yes. Develop Solution Brief uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Develop Solution Brief free?

Develop Solution Brief is open source on GitHub under the Apache-2.0 license. It is free to install; check the license before commercial use.

Who made Develop Solution Brief?

Develop Solution Brief is published by product-on-purpose in the product-on-purpose/pm-skills repository, together with 29 other skills.

Similar skills. From other creators.