How do I install the Skill Product Solution Blueprint skill?

Run npx skillmds@latest add tomevault-io/skill-product-solution-blueprint in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Product Solution Blueprint safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Product Solution Blueprint?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Product Solution Blueprint free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Product Solution Blueprint?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Product Solution Blueprint by tomevault-io

Name: Skill Product Solution Blueprint
Author: tomevault-io

File contents

Solution Blueprinting

1. Objective

To translate abstract "Vision" into concrete "Requirements" without writing code. This skill powers the Solution Architect (p04) agent.

2. Text-Based UX Flows (The "Skeleton")

Constraint: Do NOT use Mermaid graphs for detailed logical flows. Use text lists.

Template

Use the Official Template for the full structure.

Syntax Example

### Flow 1: [User Story Name]
- **Size:** M (60h) | **LLM Friendly:** 0.8
1. User [Action] on [Page/Component].
   - *System:* [Validates/Checks/Loads].
   - *Error Path:* If [Condition], show [Error Message].
2. User sees [Result].

3. Business Case (Enhanced ROI)

Logic Locker (CRITICAL)

[!IMPORTANT] FORBIDDEN ACTION: You are strictly forbidden from calculating ROI/NPV manually. You MUST first list all User Stories with sizes + friendliness, then run the script.

Protocol

Estimate: For each user story, assign a Size (XS, S, M, L, XL) and LLM Friendliness (0.0 - 1.0).

Prepare: Create a temp JSON file in docs/product/ (e.g., docs/product/stories.json):

{
  "stories": [
    { "name": "Login", "size": "S", "llm_friendly": 0.9 },
    { "name": "Complex Dashboard", "size": "L", "llm_friendly": 0.3 }
  ]
}

Execute:

# Usage: python3 [skill_path]/scripts/calculate_roi.py --file docs/product/stories.json --users <SOM> --price <PRICE>
python3 [skill_path]/scripts/calculate_roi.py --file docs/product/stories.json --users 5000 --price 29.99

Output Interpretation

NPV (Net Present Value): Must be Positive.
Payback Period: Ideal < 12 months.
ROI: Ideal > 3.0x.
LTV/CAC: Ideal > 3.0x.
Verdict: Script provides "Strong Case", "Long Game", or "Risky". Trust it.

4. Risk Register

Track top 5 risks using this structure:

Risk ID	Risk Description	Impact (1-5)	Likelihood (1-5)	Mitigation Strategy
R01	API Limit Hit	5	3	Use Rotating Proxies

5. Handoff Readiness

The output must be ready for handoff_to_technical.py.

Constraint: Ensure all NFRs (Non-Functional Requirements) are quantifiable (e.g. "Sub-200ms latency", not "Fast").

6. Examples

Simple (B2C): examples/01_simple_flexarb.md
Advanced (B2B SaaS): examples/02_advanced_loyaltyhub.md

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: skill-product-solution-blueprintdescription: Guidelines for creating Solution Blueprints (UX Flows, ROI, Risk Registers) for BRD preparation. Use when this capability is needed.---# Solution Blueprinting## 1. ObjectiveTo translate abstract "Vision" into concrete "Requirements" without writing code. This skill powers the **Solution Architect (p04)** agent.## 2. Text-Based UX Flows (The "Skeleton")**Constraint:** Do NOT use Mermaid graphs for detailed logical flows. Use text lists.### Template> **[Use the Official Template](assets/solution_blueprint_template.md)** for the full structure.### Syntax Example```markdown### Flow 1: [User Story Name]- **Size:** M (60h) | **LLM Friendly:** 0.81. User [Action] on [Page/Component]. - *System:* [Validates/Checks/Loads]. - *Error Path:* If [Condition], show [Error Message].2. User sees [Result].```## 3. Business Case (Enhanced ROI)### Logic Locker (CRITICAL)> [!IMPORTANT]> **FORBIDDEN ACTION:** You are **strictly forbidden** from calculating ROI/NPV manually.> You MUST first list all User Stories with sizes + friendliness, then run the script.### Protocol1. **Estimate**: For each user story, assign a Size (XS, S, M, L, XL) and LLM Friendliness (0.0 - 1.0).2. **Prepare**: Create a temp JSON file in `docs/product/` (e.g., `docs/product/stories.json`): ```json { "stories": [ { "name": "Login", "size": "S", "llm_friendly": 0.9 }, { "name": "Complex Dashboard", "size": "L", "llm_friendly": 0.3 } ] } ```3. **Execute**: ```bash # Usage: python3 [skill_path]/scripts/calculate_roi.py --file docs/product/stories.json --users <SOM> --price <PRICE> python3 [skill_path]/scripts/calculate_roi.py --file docs/product/stories.json --users 5000 --price 29.99 ```### Output Interpretation- **NPV (Net Present Value):** Must be Positive.- **Payback Period:** Ideal < 12 months.- **ROI:** Ideal > 3.0x.- **LTV/CAC:** Ideal > 3.0x.- **Verdict:** Script provides "Strong Case", "Long Game", or "Risky". Trust it.## 4. Risk RegisterTrack top 5 risks using this structure:| Risk ID | Risk Description | Impact (1-5) | Likelihood (1-5) | Mitigation Strategy ||---------|------------------|--------------|------------------|---------------------|| R01 | API Limit Hit | 5 | 3 | Use Rotating Proxies|## 5. Handoff ReadinessThe output must be ready for `handoff_to_technical.py`.- **Constraint:** Ensure all NFRs (Non-Functional Requirements) are quantifiable (e.g. "Sub-200ms latency", not "Fast").## 6. Examples- **Simple (B2C):** `examples/01_simple_flexarb.md`- **Advanced (B2B SaaS):** `examples/02_advanced_loyaltyhub.md`---> Converted and distributed by [TomeVault](https://tomevault.io/claim/matrixfounder) — claim your Tome and manage your conversions.

Frequently asked questions

Skill Product Solution Blueprint