skills/by-role/data-scientist/data-story/SKILL.md
Communicate data insights to non-technical stakeholders in a structured, persuasive format. Use when the user says "present these findings", "explain this analysis to leadership", "make a data presentation", "tell the story behind the data", "translate this into a business narrative", "make this insight actionable", "stakeholder readout", "executive summary of results", or needs to turn analysis output into a decision-ready document or slide deck.
npx skillsauth add qa-aman/claude-skills data-storyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Based on "Storytelling with Data" by Cole Nussbaumer Knaflic. The core principle: data does not speak for itself. Context, audience, and a clear call to action determine whether an insight drives a decision or gets ignored. Every data communication is a story with a protagonist (the audience), a tension (the problem), and a resolution (the recommended action). Remove everything that doesn't serve that arc.
Before touching a chart or a sentence, answer:
Write one sentence: "After seeing this, [audience] should [specific action or decision]."
This sentence controls everything downstream.
Knaflic's rule: the insight goes first. The supporting evidence follows.
Structure:
Bad order: "We ran a 4-week A/B test. We measured conversion, retention, and revenue. Here are the results. [charts] Based on this, we recommend..." Good order: "Variant B increased revenue per user by 12%. Here's why it worked and what we should do next."
Do not show a chart because you have it. Show a chart because it communicates something words cannot.
Chart selection guide:
Remove: dual-axis charts, 3D charts, pie charts with > 3 slices, and any chart where the title is a label instead of an insight.
Each chart should have:
Apply Knaflic's preattentive attributes to guide attention: use color sparingly (one accent color for the key insight), use bold or size for emphasis, use position to show ranking.
For a written report or slide deck, each insight needs a three-part structure:
Headline (1 line): The finding, stated as a conclusion.
Evidence (2-3 bullets): The numbers that prove the headline.
Implication (1 line): What this means for the decision at hand.
Example:
Headline: Power users drive 80% of revenue despite being 12% of accounts.
Evidence:
- Top 12% of accounts by login frequency generated $4.2M of $5.3M total ARR.
- Median revenue per power user: $1,400/yr vs. $90/yr for casual users.
- Power users churn at 4% annually vs. 31% for casual users.
Implication: Retention investment should prioritize power user health, not broad activation.
Before finalizing, cut:
End every presentation or report with a single, explicit ask: "We recommend [action]. We need [decision] by [date] to [outcome]."
1. The data dump Bad: Sharing a 40-chart dashboard and telling the audience to "explore it". Good: Curating 3-5 charts that build a specific argument and presenting them in order.
2. Titles that describe instead of conclude Bad: Chart title = "Monthly Active Users by Segment, Jan-Dec" Good: Chart title = "Enterprise segment MAU grew 34%; SMB flat for 6 months"
3. Using color for decoration Bad: Each bar in a bar chart is a different color. Good: All bars are grey except the one being discussed, which is the accent color.
4. Burying the recommendation at the end Bad: Walking through all the analysis before stating what the audience should do. Good: State the recommendation in the first 30 seconds or on slide 2. Everything after is evidence.
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.