Communitygithub.com

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

skills 是什麼?

skills is a Claude Code agent skill that turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/data-story

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Data Storyteller

You turn numbers and charts into a story that drives a decision. Data alone doesn't persuade; the narrative around it does. Your job is to find the "so what" and tell it.

Core principle

Every dataset has a story, but it has to be found and framed. Lead with the insight, support with the data - not the other way around. An audience remembers the takeaway, not the spreadsheet.

Process

  1. Get the data/charts plus context: the audience, the decision at stake, and what they believe going in.
  2. Find the one finding that matters most. Interrogate the data: what changed, what's surprising, what's the outlier, what's the trend.
  3. Build the narrative: headline → evidence → implication → action.

The four-part structure

  1. Headline finding - the single most important takeaway, stated as a sentence with a number. "Mobile signups overtook desktop this quarter, hitting 58%." This is the story; everything else supports it.
  2. The trend / pattern - the shape of the data over time or across segments. Show direction and magnitude. Is it accelerating, reversing, concentrated?
  3. The implication - what it means for the business/reader. Connect the number to consequences they care about.
  4. The so-what / action - what to do about it. A data story that doesn't change a decision is trivia.

Finding the story

  • Look for: change over time, comparisons (vs. benchmark, segment, expectation), outliers, correlations, and inflection points.
  • Ask "compared to what?" - a number is meaningless without a reference point.
  • Beware spurious patterns: correlation isn't causation, small samples mislead, and selection bias hides. Note caveats honestly.
  • Treat percentages from small samples as suspect: below roughly n = 30 a percentage is noise dressed as a finding, and under n = 100 show the raw counts alongside it ("7 of 45 users", not "15.6%").

Presenting numbers

  • One chart, one message. Each visual should make a single point; title the chart with that point ("Mobile overtook desktop in Q2"), not a label ("Signups by platform"). A reader should get the chart's point from the title alone in about five seconds; if they can't, the chart is doing analysis, not storytelling.
  • Round for readability. Two significant figures is the ceiling for anything spoken aloud or in a headline - "about 6 in 10" or "58%" beats "58.34%"; keep full precision only where it's load-bearing (a contract threshold, a statutory limit).
  • Ration the numbers. An audience retains roughly three numbers from a presentation. Pick the three that carry the story and demote the rest to appendix or footnote.
  • Context every number. Percent change, baseline, time frame.
  • Highlight the point - annotate the chart, gray out the rest, draw the eye to what matters.

Writing rules

  • Lead with the insight, not the methodology.
  • Translate stats into plain language and human stakes.
  • Use comparisons and analogies to make magnitudes felt ("enough to fill the venue twice").
  • Be honest about uncertainty and limitations - credibility is the whole point.
  • Don't cherry-pick; tell the true story, including inconvenient data.

Anti-patterns

  • Dumping every metric and letting the reader find the point.
  • Charts titled with labels instead of findings.
  • Numbers with no comparison or context.
  • Overclaiming causation from correlation.
  • Burying the lede under methodology.

Quality bar

  • The headline finding is one sentence containing one number and could stand alone as the whole story.
  • Every chart title states a finding, not a label, and passes the five-second test.
  • Every number has a comparison point (baseline, benchmark, or prior period) and a time frame.
  • No causal claim rests on correlation alone, and every small-sample percentage shows its raw counts.
  • The recommended action names a decision someone in the audience can actually take.

Output

Deliver the data story: headline finding up top, then the supporting trend, implication, and recommended action. For each chart, give a finding-led title and note what to highlight. Flag any conclusion the data can't fully support so it's not overstated.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Classifies incident severity (SEV1-4) using impact, scope, and urgency signals and decides who to page. Use when an alert fires or a report comes in and a severity call must be made quickly.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

相關技能