Roi Report

by yohayetsion

skill

View ROI dashboard showing time saved across sessions

Skill Details

Repository Files

1 file in this skill directory


name: roi-report description: View ROI dashboard showing time saved across sessions model: haiku tools:

  • Read
  • Glob

ROI Report

Generate a report showing time savings from using the Product Org OS.

SCOPE: All time savings represent PRODUCT MANAGEMENT WORK (strategy, decisions, requirements, GTM, analysis, documentation), NOT software development or coding effort.

Trigger Patterns

  • /roi-report - Show full dashboard
  • /roi-report session - Show current session only
  • /roi-report [period] - Show specific period (30d, 90d, month, quarter)

Behavior

1. Load Data Sources

Read relevant files to compile ROI data:

Session log: context/roi/session-log.md
History: context/roi/history/*.md
Baselines: reference/roi-baselines.md

2. Calculate Metrics

Per-Session Metrics:

  • Total interactions this session
  • Time saved this session
  • Top skills used

Period Metrics (30/90 day):

  • Total interactions
  • Total time saved
  • Skills by frequency
  • Skills by time saved
  • Average time saved per interaction

ROI Multiple:

ROI Multiple = Time Saved / Time Using Plugin

Assume average interaction takes 2-3 minutes of user time.

3. Output Format

# Product Org OS - ROI Dashboard

**Report Generated**: [date]
**Period**: [session | 30 days | 90 days | all time]

---

## Summary

| Metric | Value |
|--------|-------|
| Total Interactions | [N] |
| Total Time Saved | ~[X] hours |
| ROI Multiple | [Y]x |

---

## This Session

| Skill/Agent | Count | Time Saved |
|-------------|-------|------------|
| /prd | 2 | ~8 hours |
| @pm | 3 | ~4 hours |
| /decision-record | 1 | ~1.5 hours |

**Session Total**: ~13.5 hours saved

---

## Top Skills by Time Saved (Period)

| Rank | Skill | Uses | Total Time Saved |
|------|-------|------|------------------|
| 1 | /prd | 12 | ~48 hours |
| 2 | /strategic-bet | 8 | ~24 hours |
| 3 | @plt | 5 | ~20 hours |
| 4 | /gtm-strategy | 6 | ~18 hours |
| 5 | /business-case | 4 | ~12 hours |

---

## Top Skills by Frequency (Period)

| Rank | Skill | Uses | Avg Time/Use |
|------|-------|------|--------------|
| 1 | /user-story | 45 | ~25 min |
| 2 | /decision-record | 28 | ~60 min |
| 3 | /context-recall | 24 | ~10 min |
| 4 | @pm | 18 | ~90 min |
| 5 | /feature-spec | 15 | ~75 min |

---

## Monthly Trend

| Month | Interactions | Time Saved | ROI Multiple |
|-------|-------------|------------|--------------|
| Jan 2026 | 156 | ~78 hours | 15x |
| Dec 2025 | 142 | ~71 hours | 14x |
| Nov 2025 | 98 | ~49 hours | 12x |

---

## Category Breakdown

| Category | % of Usage | Time Saved |
|----------|-----------|------------|
| Requirements | 35% | ~40 hours |
| Strategy | 25% | ~35 hours |
| Context/Memory | 20% | ~15 hours |
| GTM/Marketing | 12% | ~18 hours |
| Decisions | 8% | ~12 hours |

---

*Time estimates based on manual product management work. See reference/roi-baselines.md for methodology.*

4. Empty State

If no data exists yet:

# Product Org OS - ROI Dashboard

**No usage data recorded yet.**

Start using skills and agents to begin tracking your ROI:

- `/prd [topic]` - Create a PRD (~4 hours saved vs. manual writing + stakeholder reviews)
- `/decision-record [topic]` - Document a decision (~1 hour saved vs. manual documentation + alignment)
- `@pm [question]` - Get PM perspective (~1-2 hours saved vs. manual analysis + research)

Each completed skill/agent interaction is automatically logged with its time-savings estimate.

Note: All time savings represent PRODUCT WORK (research, analysis, documentation, stakeholder alignment), not development effort.

Session Log Format

The session log (context/roi/session-log.md) should follow this format:

# Session ROI Log

## Current Session: [YYYY-MM-DD]

| Time | Skill/Agent | Topic | Complexity | Time Saved |
|------|-------------|-------|------------|------------|
| 09:15 | /prd | Authentication | Standard | 240 min |
| 10:30 | @pm | PRD review | Simple | 60 min |
| 11:45 | /decision-record | API versioning | Standard | 75 min |

**Session Total**: 375 min (~6.25 hours)

History File Format

Monthly history files (context/roi/history/YYYY-MM.md):

# ROI History: [Month Year]

## Summary
- Total Interactions: [N]
- Total Time Saved: [X] hours
- Top Skill: [skill] ([count] uses)

## Daily Breakdown

### [Date]
| Skill/Agent | Count | Time Saved |
|-------------|-------|------------|
| ... | ... | ... |

**Day Total**: [X] hours

Complexity Factor Reference

When logging interactions, complexity affects time saved:

Complexity Factor Signals
Simple 0.5× Quick question, single topic, no research needed
Standard 1.0× Typical usage, moderate scope
Complex 1.5× Multi-part, requires research, significant scope
Enterprise 2.0× Large scale, multiple stakeholders, strategic

Notes

  • ROI tracking is opt-in via the roi_display setting
  • Setting roi_display: none disables per-interaction display
  • Setting roi_display: minimal shows only the time saved line
  • History is preserved even if display is disabled
  • All time estimates are approximations based on manual product management work (NOT development/coding)

Related Skills

Attack Tree Construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

skill

Grafana Dashboards

Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.

skill

Matplotlib

Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.

skill

Scientific Visualization

Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.

skill

Seaborn

Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.

skill

Shap

Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Query Writing

For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations

skill

Pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

skill

Scientific Visualization

Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.

skill

Skill Information

Category:Skill
Last Updated:1/26/2026