Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
Transform data into compelling narratives with effective chart selection, annotation, and insight framing.
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
SKILL.md
1---2name: data-storytelling3description: Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.4---56# Data Storytelling78Transform raw data into compelling narratives that drive decisions and inspire action.910## When to Use This Skill1112- Presenting analytics to executives13- Creating quarterly business reviews14- Building investor presentations15- Writing data-driven reports16- Communicating insights to non-technical audiences17- Making recommendations based on data1819## Core Concepts2021### 1. Story Structure2223```24Setup → Conflict → Resolution2526Setup: Context and baseline27Conflict: The problem or opportunity28Resolution: Insights and recommendations29```3031### 2. Narrative Arc3233```341. Hook: Grab attention with surprising insight352. Context: Establish the baseline363. Rising Action: Build through data points374. Climax: The key insight385. Resolution: Recommendations396. Call to Action: Next steps40```4142### 3. Three Pillars4344| Pillar | Purpose | Components |45| ------------- | -------- | -------------------------------- |46| **Data** | Evidence | Numbers, trends, comparisons |47| **Narrative** | Meaning | Context, causation, implications |48| **Visuals** | Clarity | Charts, diagrams, highlights |4950## Story Frameworks5152### Framework 1: The Problem-Solution Story5354```markdown55# Customer Churn Analysis5657## The Hook5859"We're losing $2.4M annually to preventable churn."6061## The Context6263- Current churn rate: 8.5% (industry average: 5%)64- Average customer lifetime value: $4,80065- 500 customers churned last quarter6667## The Problem6869Analysis of churned customers reveals a pattern:7071- 73% churned within first 90 days72- Common factor: < 3 support interactions73- Low feature adoption in first month7475## The Insight7677[Show engagement curve visualization]78Customers who don't engage in the first 14 days79are 4x more likely to churn.8081## The Solution82831. Implement 14-day onboarding sequence842. Proactive outreach at day 7853. Feature adoption tracking8687## Expected Impact8889- Reduce early churn by 40%90- Save $960K annually91- Payback period: 3 months9293## Call to Action9495Approve $50K budget for onboarding automation.96```9798### Framework 2: The Trend Story99100```markdown101# Q4 Performance Analysis102103## Where We Started104105Q3 ended with $1.2M MRR, 15% below target.106Team morale was low after missed goals.107108## What Changed109110[Timeline visualization]111112- Oct: Launched self-serve pricing113- Nov: Reduced friction in signup114- Dec: Added customer success calls115116## The Transformation117118[Before/after comparison chart]119| Metric | Q3 | Q4 | Change |120|----------------|--------|--------|--------|121| Trial → Paid | 8% | 15% | +87% |122| Time to Value | 14 days| 5 days | -64% |123| Expansion Rate | 2% | 8% | +300% |124125## Key Insight126127Self-serve + high-touch creates compound growth.128Customers who self-serve AND get a success call129have 3x higher expansion rate.130131## Going Forward132133Double down on hybrid model.134Target: $1.8M MRR by Q2.135```136137### Framework 3: The Comparison Story138139```markdown140# Market Opportunity Analysis141142## The Question143144Should we expand into EMEA or APAC first?145146## The Comparison147148[Side-by-side market analysis]149150### EMEA151152- Market size: $4.2B153- Growth rate: 8%154- Competition: High155- Regulatory: Complex (GDPR)156- Language: Multiple157158### APAC159160- Market size: $3.8B161- Growth rate: 15%162- Competition: Moderate163- Regulatory: Varied164- Language: Multiple165166## The Analysis167168[Weighted scoring matrix visualization]169170| Factor | Weight | EMEA Score | APAC Score |171| ----------- | ------ | ---------- | ---------- |172| Market Size | 25% | 5 | 4 |173| Growth | 30% | 3 | 5 |174| Competition | 20% | 2 | 4 |175| Ease | 25% | 2 | 3 |176| **Total** | | **2.9** | **4.1** |177178## The Recommendation179180APAC first. Higher growth, less competition.181Start with Singapore hub (English, business-friendly).182Enter EMEA in Year 2 with localization ready.183184## Risk Mitigation185186- Timezone coverage: Hire 24/7 support187- Cultural fit: Local partnerships188- Payment: Multi-currency from day 1189```190191## Visualization Techniques192193### Technique 1: Progressive Reveal194195```markdown196Start simple, add layers:197198Slide 1: "Revenue is growing" [single line chart]199Slide 2: "But growth is slowing" [add growth rate overlay]200Slide 3: "Driven by one segment" [add segment breakdown]201Slide 4: "Which is saturating" [add market share]202Slide 5: "We need new segments" [add opportunity zones]203```204205### Technique 2: Contrast and Compare206207```markdown208Before/After:209┌─────────────────┬─────────────────┐210│ BEFORE │ AFTER │211│ │ │212│ Process: 5 days│ Process: 1 day │213│ Errors: 15% │ Errors: 2% │214│ Cost: $50/unit │ Cost: $20/unit │215└─────────────────┴─────────────────┘216217This/That (emphasize difference):218┌─────────────────────────────────────┐219│ CUSTOMER A vs B │220│ ┌──────────┐ ┌──────────┐ │221│ │ ████████ │ │ ██ │ │222│ │ $45,000 │ │ $8,000 │ │223│ │ LTV │ │ LTV │ │224│ └──────────┘ └──────────┘ │225│ Onboarded No onboarding │226└─────────────────────────────────────┘227```228229### Technique 3: Annotation and Highlight230231```python232import matplotlib.pyplot as plt233import pandas as pd234235fig, ax = plt.subplots(figsize=(12, 6))236237# Plot the main data238ax.plot(dates, revenue, linewidth=2, color='#2E86AB')239240# Add annotation for key events241ax.annotate(242'Product Launch\n+32% spike',243xy=(launch_date, launch_revenue),244xytext=(launch_date, launch_revenue * 1.2),245fontsize=10,246arrowprops=dict(arrowstyle='->', color='#E63946'),247color='#E63946'248)249250# Highlight a region251ax.axvspan(growth_start, growth_end, alpha=0.2, color='green',252label='Growth Period')253254# Add threshold line255ax.axhline(y=target, color='gray', linestyle='--',256label=f'Target: ${target:,.0f}')257258ax.set_title('Revenue Growth Story', fontsize=14, fontweight='bold')259ax.legend()260```261262## Presentation Templates263264### Template 1: Executive Summary Slide265266```267┌─────────────────────────────────────────────────────────────┐268│ KEY INSIGHT │269│ ══════════════════════════════════════════════════════════│270│ │271│ "Customers who complete onboarding in week 1 │272│ have 3x higher lifetime value" │273│ │274├──────────────────────┬──────────────────────────────────────┤275│ │ │276│ THE DATA │ THE IMPLICATION │277│ │ │278│ Week 1 completers: │ ✓ Prioritize onboarding UX │279│ • LTV: $4,500 │ ✓ Add day-1 success milestones │280│ • Retention: 85% │ ✓ Proactive week-1 outreach │281│ • NPS: 72 │ │282│ │ Investment: $75K │283│ Others: │ Expected ROI: 8x │284│ • LTV: $1,500 │ │285│ • Retention: 45% │ │286│ • NPS: 34 │ │287│ │ │288└──────────────────────┴──────────────────────────────────────┘289```290291### Template 2: Data Story Flow292293```294Slide 1: THE HEADLINE295"We can grow 40% faster by fixing onboarding"296297Slide 2: THE CONTEXT298Current state metrics299Industry benchmarks300Gap analysis301302Slide 3: THE DISCOVERY303What the data revealed304Surprising finding305Pattern identification306307Slide 4: THE DEEP DIVE308Root cause analysis309Segment breakdowns310Statistical significance311312Slide 5: THE RECOMMENDATION313Proposed actions314Resource requirements315Timeline316317Slide 6: THE IMPACT318Expected outcomes319ROI calculation320Risk assessment321322Slide 7: THE ASK323Specific request324Decision needed325Next steps326```327328### Template 3: One-Page Dashboard Story329330```markdown331# Monthly Business Review: January 2024332333## THE HEADLINE334335Revenue up 15% but CAC increasing faster than LTV336337## KEY METRICS AT A GLANCE338339┌────────┬────────┬────────┬────────┐340│ MRR │ NRR │ CAC │ LTV │341│ $125K │ 108% │ $450 │ $2,200 │342│ ▲15% │ ▲3% │ ▲22% │ ▲8% │343└────────┴────────┴────────┴────────┘344345## WHAT'S WORKING346347✓ Enterprise segment growing 25% MoM348✓ Referral program driving 30% of new logos349✓ Support satisfaction at all-time high (94%)350351## WHAT NEEDS ATTENTION352353✗ SMB acquisition cost up 40%354✗ Trial conversion down 5 points355✗ Time-to-value increased by 3 days356357## ROOT CAUSE358359[Mini chart showing SMB vs Enterprise CAC trend]360SMB paid ads becoming less efficient.361CPC up 35% while conversion flat.362363## RECOMMENDATION3643651. Shift $20K/mo from paid to content3662. Launch SMB self-serve trial3673. A/B test shorter onboarding368369## NEXT MONTH'S FOCUS370371- Launch content marketing pilot372- Complete self-serve MVP373- Reduce time-to-value to < 7 days374```375376## Writing Techniques377378### Headlines That Work379380```markdown381BAD: "Q4 Sales Analysis"382GOOD: "Q4 Sales Beat Target by 23% - Here's Why"383384BAD: "Customer Churn Report"385GOOD: "We're Losing $2.4M to Preventable Churn"386387BAD: "Marketing Performance"388GOOD: "Content Marketing Delivers 4x ROI vs. Paid"389390Formula:391[Specific Number] + [Business Impact] + [Actionable Context]392```393394### Transition Phrases395396```markdown397Building the narrative:398• "This leads us to ask..."399• "When we dig deeper..."400• "The pattern becomes clear when..."401• "Contrast this with..."402403Introducing insights:404• "The data reveals..."405• "What surprised us was..."406• "The inflection point came when..."407• "The key finding is..."408409Moving to action:410• "This insight suggests..."411• "Based on this analysis..."412• "The implication is clear..."413• "Our recommendation is..."414```415416### Handling Uncertainty417418```markdown419Acknowledge limitations:420• "With 95% confidence, we can say..."421• "The sample size of 500 shows..."422• "While correlation is strong, causation requires..."423• "This trend holds for [segment], though [caveat]..."424425Present ranges:426• "Impact estimate: $400K-$600K"427• "Confidence interval: 15-20% improvement"428• "Best case: X, Conservative: Y"429```430431## Best Practices432433### Do's434435- **Start with the "so what"** - Lead with insight436- **Use the rule of three** - Three points, three comparisons437- **Show, don't tell** - Let data speak438- **Make it personal** - Connect to audience goals439- **End with action** - Clear next steps440441### Don'ts442443- **Don't data dump** - Curate ruthlessly444- **Don't bury the insight** - Front-load key findings445- **Don't use jargon** - Match audience vocabulary446- **Don't show methodology first** - Context, then method447- **Don't forget the narrative** - Numbers need meaning448