value-realization

Analyze if end users discover clear value. Use when evaluating product concepts, analyzing adoption, or uncertain about direction.

210 stars

Best use case

value-realization is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Analyze if end users discover clear value. Use when evaluating product concepts, analyzing adoption, or uncertain about direction.

Teams using value-realization should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/value-realization/SKILL.md --create-dirs "https://raw.githubusercontent.com/flpbalada/my-opencode-config/main/skills/value-realization/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/value-realization/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How value-realization Compares

Feature / Agentvalue-realizationStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Analyze if end users discover clear value. Use when evaluating product concepts, analyzing adoption, or uncertain about direction.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

This skill provides a comprehensive framework for evaluating whether end users can "know" what value they'll achieve through a product. It combines analytical methods with decision-making guidance to help you assess product ideas, identify improvement opportunities, and take action.

**What this skill provides**:
- Four-dimension analysis framework (Clarity, Timeline, Perception, Discovery)
- Assessment rubrics for each dimension with scoring guidance
- Decision framework for taking action based on analysis
- B2B/B2E enterprise context guidance
- Prioritization guidance for different product types
- User segmentation by journey stage and persona
- Success criteria and actionable outputs

**Core question**: Can end users clearly understand what value they'll achieve through the product - even if that value takes time to achieve?

**Key terminology**:
- **User**: You (product creator, PM, designer, entrepreneur, etc.)
- **End user**: The person who will use the product being discussed
- **Value**: The outcomes end users achieve (identity, financial gain, capability, time savings, etc.)
- **Features**: The product's technical capabilities

**Core distinction**: Features are not value - features are what the product can do, value is what end users achieve.

## Analysis Framework: Four Dimensions

When analyzing a product idea, evaluate these four dimensions systematically:

### Dimension 1: Value Clarity

**Examine**: Can end users articulate what they'll achieve?

**Why it matters**: End users won't adopt a product if they can't explain to themselves (or others) why they're using it.

**Examples**:
- ✅ **Dropbox**: "Access my files from any device" (clear outcome)
- ❌ **Google Wave**: "Unified communication" (vague, abstract)

**Assessment Rubric**:

| Score | Criteria | Description |
| ----- | -------- | ----------- |
| 🔴 **1** | Fragmented | End users cannot explain what they'll achieve; describe features only |
| 🟡 **2** | Partial | End users can explain but struggle to communicate to others; vague wording |
| 🟢 **3** | Clear | End users clearly articulate what they'll achieve; can explain to others |
| 🟢 **4** | Crisp | End users describe value in one concrete sentence anyone understands |

### Dimension 2: Value Timeline

**Examine**: Is value immediate or delayed? What's the appropriate timeline for this product?

**Three design options** (all are valid):

| Approach | Best For | Examples |
| -------- | ------- | -------- |
| **Pure short-term** | Tool-type products, utility apps | Zoom (join meeting), Stripe (test payment) |
| **Pure long-term** | Transformational goals, committed users | Fitness apps (body change), Investment apps (wealth building) |
| **Hybrid** | Long-term goal requiring engagement | Duolingo (fluency with streaks, XP) |

**Assessment Rubric**:

| Score | Criteria | Description |
| ----- | -------- | ----------- |
| 🔴 **1** | Mismatched | Timeline conflicts with end user expectations (e.g., long-term product marketed as immediate) |
| 🟡 **2** | Unclear | Timeline undefined; end users don't know when to expect value |
| 🟢 **3** | Aligned | Timeline matches product nature and end user expectations |
| 🟢 **4** | Optimized | Timeline intentionally designed with engaging touchpoints |

### Dimension 3: Value Perception

**Examine**: Can end users see/feel what they achieved?

**Why it matters**: Invisible value feels like no value. Progress must be perceivable.

**Examples**:
- ✅ **Visible outcomes**: File sync status (Dropbox), likes count (Instagram), contribution graph (GitHub)
- ❌ **Invisible outcomes**: "Your data is synced", "Security improved", "Algorithm optimized"

**Assessment Rubric**:

| Score | Criteria | Description |
| ----- | -------- | ----------- |
| 🔴 **1** | Invisible | End users cannot see any evidence of value; changes are completely abstract |
| 🟡 **2** | Opaque | Value delivered but not shown; requires digging to find evidence |
| 🟢 **3** | Visible | End users can see progress; value has tangible manifestations |
| 🟢 **4** | Salient | Value is prominently displayed; end users are constantly reminded of achievements |

### Dimension 4: Value Discovery

**Examine**: Do end users already know they want this, or will they discover it through use?

**Why it matters**: Sometimes end users don't know what they want until they experience it. The product must enable rapid discovery.

**Discovery patterns**:
- ✅ **Instagram**: End users thought they wanted "share photos", discovered they valued "become a photographer" (identity)
- ✅ **Notion**: End users thought they wanted "take notes", discovered they valued "become organized" (identity)

**Assessment Rubric**:

| Score | Criteria | Description |
| ----- | -------- | ----------- |
| 🔴 **1** | No path | Discovery possible but no clear onboarding; end users struggle to find value |
| 🟡 **2** | Slow path | Aha moment exists but takes too long (weeks/months) to reach |
| 🟢 **3** | Fast path | Most end users discover value within first session |
| 🟢 **4** | Accelerated | Discovery actively guided through tutorial, onboarding, or progressive revelation |

## Progressive Disclosure

This skill provides detailed examples through context files. Load them when needed:

| Context File                    | When to Load                                    |
| ------------------------------- | ----------------------------------------------- |
| `context/decision-flow.md`      | Scoring trade-offs, journey stage analysis, ready-to-ship criteria |
| `context/enterprise-guide.md`   | B2B/B2E products with separate buyer/end-user analysis |
| `context/examples.md`            | Real-world success/failure case studies (Dropbox, Duolingo, Instagram, Google Wave, Quibi) |

## Decision Framework

### Overall Score Calculation

Score = Sum of dimension scores / 4

- **1.0-1.5**: Critical (immediate action)
- **2.0-2.5**: Needs work (priority improvements)
- **3.0-3.5**: Good (iterate and optimize)
- **4.0**: Excellent (maintain momentum)

### Priority Improvements (Score 2.0-2.8)

**If Value Clarity is 🔴 or 🟡 (priority #1)**:
- Rewrite value propositions using "outcome, not feature" framing
- Run 5-second tests with 10 target users
- Success: 80%+ can explain the value

**If Value Timeline is mismatched (priority #2)**:
- Align timeline with end user expectations

**If Value Perception is 🔴 or 🟡 (priority #3)**:
- Make progress visible with dashboards, notifications, progress indicators

**If Value Discovery is 🔴 or 🟡 (priority #4)**:
- Accelerate time-to-aha
- Map user journey from signup to value realization

## Product Type Matrix

| Product Type | Clarity | Timeline | Perception | Discovery | Notes |
| ------------ | ------- | -------- | ---------- | --------- | ----- |
| **Social apps** | High | Medium | Medium | High | Identity discovery critical |
| **Productivity tools** | High | High | High | Medium | Utility must be immediate and visible |
| **Infrastructure/Dev tools** | Medium | High | High | Medium | Perception > Clarity (technical users) |
| **Gaming/Entertainment** | Medium | High | High | High | Engagement loops matter |
| **Enterprise B2B** | Medium | Medium | High | Low | Decision-maker evaluation different |
| **Marketplaces/Platforms** | High | High | Medium | Medium | Trust signals and outcomes |

## Common Pitfalls

### Pitfall 1: One-Dimension Fixes

**Mistake**: Fixing only one dimension (e.g., clarity) and ignoring others.

**Reality**: Weak perception undermines even excellent clarity.

**Avoid**: Always evaluate all four dimensions.

### Pitfall 2: Feature-Centric Messaging

**Mistake**: Listing features instead of outcomes.

**Reality**: End users don't care about "X feature," they care about "achieve Y."

**Avoid**: Use "feature name → end user outcome" mapping for all messaging.

### Pitfall 3: Timeline Mismatch

**Mistake**: Long-term product marketed as immediate (or vice versa).

**Reality**: Timeline mismatch creates end user frustration and churn.

**Avoid**: Clearly communicate timeline. If long-term, explain what short-term touchpoints exist.

### Pitfall 4: Invisible Value

**Mistake**: Delivering great value that end users can't see.

**Reality**: Invisible = no value in end user perception.

**Avoid**: Always ask "Can end users point to something and say 'I achieved this'?"

### Pitfall 5: Ignoring Discovery Path

**Mistake**: Assuming end users will "figure it out."

**Reality**: Most won't take time to discover value through trial and error.

**Avoid**: Explicitly design the "aha moment" journey from signup to realization.

### Pitfall 6: B2B Focusing Only on Buyers

**Mistake**: Enterprise products that sell to CIOs but fail with end users.

**Reality**: If employees won't use it, the deal won't renew.

**Avoid**: Separate buyer analysis from end user analysis; both must succeed. See `context/enterprise-guide.md`.

## How to Use This Skill

### When to Engage

Trigger this skill when:
- Discussing product ideas or features
- Evaluating "is this idea good?"
- Analyzing adoption or retention problems
- Planning marketing or positioning strategy
- Uncertain about product direction

### Engagement Process

1. **Identify end users** - Who will use the product?
2. **Complete four-dimension analysis** - Evaluate clarity, timeline, perception, discovery
3. **Determine product type** - Consumer, B2B, enterprise?
4. **Apply scoring and decision framework** - Score → Identify priorities → Plan actions
5. **Document findings** - Summary, decisions, action plan

### Key Principles

1. **End users must "know" what value they'll achieve** - even if delayed
2. **Value types are diverse** - identity, money, benefits, status, capability, and more
3. **End users often don't know what they want** - help them discover it
4. **Perception matters** - invisible value = no value
5. **Context is everything** - patterns from one product may not apply to others
6. **Both short-term and long-term are valid** - neither superior, choose based on product nature
7. **Test with real end users** - don't assume
8. **Score all dimensions** - trade-offs OK, ignoring dimensions not

## Integration with Other Skills

| Skill | Combined Use |
| ----- | ----------- |
| **Jobs-to-be-Done** | Analyze what jobs end users are hiring the product to do |
| **Making Product Decisions** | Document value realization analysis decisions |
| **Five Whys** | Dig into why end users struggle with specific dimensions |
| **Hypothesis Tree** | Structure value discovery hypotheses to test |

## Remember

This skill helps analyze and make decisions, not prescribe solutions. Every product is unique. Every market is different. The goal: discover whether end users will clearly understand what they'll achieve - because that understanding drives adoption.

**When in doubt**: Test with real end users. Framework guides thinking; reality validates it.

Related Skills

what-not-to-do-as-product-manager

210
from flpbalada/my-opencode-config

Anti-patterns and mistakes to avoid as a product manager. Use when evaluating leadership behaviors, improving team dynamics, reflecting on management practices, or onboarding new product managers.

visual-cues-cta-psychology

210
from flpbalada/my-opencode-config

Design effective CTAs using visual attention and gaze psychology principles. Use when designing landing pages, button hierarchies, conversion elements, or optimizing user attention flow through interfaces.

vercel-sandbox

210
from flpbalada/my-opencode-config

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

user-story-fundamentals

210
from flpbalada/my-opencode-config

Capture requirements from user perspective with structured user stories. Use when writing backlog items, defining acceptance criteria, prioritizing features, or communicating requirements between product and development.

typescript-satisfies-operator

210
from flpbalada/my-opencode-config

Guides proper usage of TypeScript's satisfies operator vs type annotations. Use this skill when deciding between type annotations (colon) and satisfies, validating object shapes while preserving literal types, or troubleshooting type inference issues.

typescript-interface-vs-type

210
from flpbalada/my-opencode-config

Guides when to use interface vs type in TypeScript. Use this skill when defining object types, extending types, or choosing between interface and type aliases.

typescript-best-practices

210
from flpbalada/my-opencode-config

Guides TypeScript best practices for type safety, code organization, and maintainability. Use this skill when configuring TypeScript projects, deciding on typing strategies, writing async code, or reviewing TypeScript code quality.

typescript-advanced-types

210
from flpbalada/my-opencode-config

Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.

trust-psychology

210
from flpbalada/my-opencode-config

Build trust signals that reduce perceived risk and enable user action. Use when designing landing pages, checkout flows, onboarding experiences, or any conversion point where user hesitation is a barrier.

theme-epic-story

210
from flpbalada/my-opencode-config

Structure product work hierarchically using themes, epics, and stories. Use when organizing backlogs, planning releases, communicating with stakeholders, or breaking down large initiatives into manageable work.

tailwind-v4-configuration

210
from flpbalada/my-opencode-config

Configure Tailwind CSS v4 with CSS-first approach. Use when installing, migrating from v3, setting up build tools (Vite/PostCSS/CLI), customizing themes with @theme, or configuring plugins.

status-quo-bias

210
from flpbalada/my-opencode-config

Understand and design for users' preference for current state over change. Use when planning migrations, introducing new features, designing defaults, or overcoming resistance to product adoption.