data-storytelling — Claude Code skill: what it does, install
This skill turns raw data into a clear narrative with context, visuals, and recommendations. Use it for analytics reports and executive presentations.
/plugin marketplace add wshobson/agents
/plugin install business-analytics@claude-code-workflowsWhat data-storytelling does
The skill shapes analytics into a decision-focused story. It helps set the baseline, frame a problem or opportunity, surface the main insight, and finish with recommendations and next steps. The material covers executive analytics, quarterly business reviews, investor presentations, data-driven reports, and explanations for non-technical audiences.
Its guidance includes the Setup → Conflict → Resolution structure, a narrative arc from an opening insight to a call to action, and the relationship between evidence, meaning, and visual clarity. It advises leading with the “so what”, curating the data, and matching vocabulary to the audience. Detailed patterns are kept in references/details.md, so check that file when the basic navigation is not enough.
What it helps with
- turn raw analytics into an executive narrative
- prepare a quarterly business review
- explain findings to a non-technical audience
- build an investor presentation from data
- write recommendations grounded in analytics
Example prompts for the agent
- Turn the data in `sales.csv` into an executive story with the main insight and next steps.
- Create an investor presentation structure with context, the core problem, key findings, and recommendations.
- Write a data-driven report and suggest visuals that clarify the main finding.
How to install data-storytelling
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install business-analytics@claude-code-workflowsThis installs the whole business-analytics plugin with all its skills
2Skills CLI (Vercel)
npx skills add wshobson/agents --skill data-storytelling -a claude-code3Manually: put the files in place
~/.claude/skills/data-storytelling/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/data-storytelling/
1Skills CLI (Vercel)
npx skills add wshobson/agents --skill data-storytelling -a codex2Manually: put the files in place
.agents/skills/data-storytelling/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wshobson/agents --skill data-storytelling -a cursor2Manually: put the files in place
.cursor/skills/data-storytelling/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wshobson/agents data-storytelling2Manually: put the files in place
.github/skills/data-storytelling/SKILL.mdPlatform CLI
gemini skills install https://github.com/wshobson/agents --path plugins/business-analytics/skills/data-storytellingManually: put the files in place
.devin/skills/data-storytelling/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set213
The whole set →Similar
Questions about data-storytelling
How do I install data-storytelling in Claude Code?
Run /plugin marketplace add wshobson/agents, then run /plugin install business-analytics@claude-code-workflows. These are the marketplace setup steps for the skill.
What does data-storytelling do?
It turns analytics into a structured narrative with context, evidence, visual support, a central insight, and recommendations. The skill is aimed at reports, presentations, and communication with non-technical audiences.
Where are the detailed data-storytelling patterns?
The detailed pattern documentation is in references/details.md. Read it when the basic navigation guidance is not enough.
Source text
SKILL.md · MIT
--- name: data-storytelling description: Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations. --- # Data Storytelling Transform raw data into compelling narratives that drive decisions and inspire action. ## When to Use This Skill - Presenting analytics to executives - Creating quarterly business reviews - Building investor presentations - Writing data-driven reports - Communicating insights to non-technical audiences - Making recommendations based on data ## Core Concepts ### 1. Story Structure ``` Setup → Conflict → Resolution Setup: Context and baseline Conflict: The problem or opportunity Resolution: Insights and recommendations ``` ### 2. Narrative Arc ``` 1. Hook: Grab attention with surprising insight 2. Context: Establish the baseline 3. Rising Action: Build through data points 4. Climax: The key insight 5. Resolution: Recommendations 6. Call to Action: Next steps ``` ### 3. Three Pillars | Pillar | Purpose | Components | | ------------- | -------- | -------------------------------- | | **Data** | Evidence | Numbers, trends, comparisons | | **Narrative** | Meaning | Context, causation, implications | | **Visuals** | Clarity | Charts, diagrams, highlights | ## Detailed patterns and worked examples Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient. ## Best Practices ### Do's - **Start with the "so what"** - Lead with insight - **Use the rule of three** - Three points, three comparisons - **Show, don't tell** - Let data speak - **Make it personal** - Connect to audience goals - **End with action** - Clear next steps ### Don'ts - **Don't data dump** - Curate ruthlessly - **Don't bury the insight** - Front-load key findings - **Don't use jargon** - Match audience vocabulary - **Don't show methodology first** - Context, then method - **Don't forget the narrative** - Numbers need meaning
© Seth Hobson · MIT · wshobson/agents