Data Storytelling

SkillDatabases & data

The data storytelling skill guides an AI agent to turn raw data into a narrative with a clear structure: hook, context, key insight, and recommendations. It is used when presenting analytics to stakeholders, creating data reports, or building executive presentations. The skill combines evidence, meaning, and visuals so the agent can shape findings into a story that supports a decision.

Use Data Storytelling in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Data Storytelling and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Data Storytelling skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add the data storytelling skill to your agent so it can load the skill file.

Data StorytellingStart free

What your AI can do with it

  • Build a narrative arc with hook, context, rising action, climax, and resolution
  • Structure a story as setup, conflict, and resolution
  • Combine data, narrative, and visuals into one presentation
  • Lead with the key insight instead of the methodology
  • Point to references/details.md for detailed patterns and worked examples

Getting started

  1. Add the data storytelling skill to your agent so it can load the skill file.
  2. Have the raw data and the audience you are presenting to ready.
  3. Ask the agent to shape the data into a story with a hook, context, key insight, and recommendations.
  4. If the built-in guidance is not enough, have the agent read references/details.md for detailed patterns and worked examples.

What this skill tells your AI

The instructions your AI receives, as published by wshobson/agents in plugins/business-analytics/skills/data-storytelling/SKILL.md and read by ahel’s review.

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

PillarPurposeComponents
DataEvidenceNumbers, trends, comparisons
NarrativeMeaningContext, causation, implications
VisualsClarityCharts, 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

Signals

GitHub stars
40k
Forks
4k
Last commit
Sep 2026

Others that do the same job

Questions

What is the data storytelling skill?
It is a skill that guides an agent to transform data into a narrative using visualization, context, and persuasive structure, for reports and presentations.
When should I use this skill?
Use it when presenting analytics to stakeholders, creating data reports, or building executive presentations, or when communicating insights to non-technical audiences.
What structure does it use?
It uses setup, conflict, and resolution, and a narrative arc of hook, context, rising action, climax, resolution, and call to action.
Advanced
Item type
skill
Key
data-storytelling-wshobson
Source
github.com/wshobson/agents