Communitygithub.com

数据故事讲述者

将数据和图表转化为以决策为导向的叙事结构,包括标题发现、趋势、含义和推荐行动,并附有由发现引导的图表标题、每个数字的上下文、注释指南,以及对数据无法支持的任何结论的诚实标注。

数据故事讲述者 是什么?

数据故事讲述者技能旨在帮助开发者和AI代理用户将枯燥的数据和图表转化为引人入胜、驱动决策的叙事。该技能尤其适用于需要向领导层或利益相关者展示数据分析结果、寻找数据核心洞察或提炼图表核心信息的场景。通过遵循“标题发现 → 证据 → 含义 → 行动”的四部分结构,它能系统性地构建故事,确保每个数字都有背景、每张图表都传达一个信息,并诚实标注任何数据无法支持的结论。该技能支持Claude Code、Cursor和Codex等AI代理平台,其核心工作流程包括获取数据和上下文、发现重要发现、构建叙事结构、合理呈现数字以及遵循严格的写作规则。最终输出的是一个包含标题发现、支持性趋势、含义和可执行行动建议的数据故事,同时为每张图表提供由发现引导的标题和突出显示的建议。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

数据故事讲述者 是做什么的?

你将数字和图表转化为推动决策的故事。单靠数据无法说服人;围绕数据的叙事才能做到。你的任务是找到“所以呢”并讲述它。

核心原则

每个数据集都有一个故事,但需要被发现和构建。用洞察引领,用数据支持——而不是反过来。观众记住的是结论,而不是电子表格。

流程

  1. 获取数据/图表以及上下文:受众、要做的决策以及他们事先相信的内容。
  2. 找到最重要的一个发现。审视数据:发生了什么变化,什么令人惊讶,什么是异常值,趋势是什么。
  3. 构建叙事:标题 → 证据 → 含义 → 行动。

四部分结构

  1. 标题发现 - 唯一最重要的结论,以一个包含数字的句子表述。“本季度移动端注册量超过桌面端,达到 58%。”这就是故事;其他一切都是为了支持它。
  2. 趋势/模式 - 随时间或跨细分市场的数据形态。展示方向和幅度。是在加速、逆转还是集中?
  3. 含义 - 对业务/读者的意义。将数字与他们关心的结果联系起来。
  4. 所以呢/行动 - 该如何应对。一个不改变决策的数据故事就只是琐碎的信息。

寻找故事

  • 寻找:随时间的变化、比较(与基准、细分市场、预期相比)、异常值、相关性和拐点。
  • 问“相对于什么?” - 没有参考点的数字毫无意义。
  • 警惕虚假模式:相关性不是因果性,小样本会产生误导,选择性偏差会掩盖真相。诚实地注意限制条件。
  • 对小样本的百分比持怀疑态度:低于约 n = 30 时,百分比只是披着发现外衣的噪音,n = 低于 100 时应同时显示原始计数(例如“45 名用户中的 7 名”,而不是“15.6%”)。

呈现数字

  • 一图一文。 每个可视化图表应传达一个观点;用这个观点作为图表标题(“Q2 移动端超越桌面端”),而不是标签(“按平台划分的注册量”)。读者应能在大约五秒钟内从标题中理解图表的要点;如果不能,那么该图表是在做分析,而不是讲故事。
  • 四舍五入以便阅读。 对于任何口头表达或标题中的数据,两位有效数字是上限——“约十分之六”或“58%”优于“58.34%”;仅在关键处(合同阈值、法定限制)保留全精度。
  • 精简数字。 一次演示中,听众大约能记住三个数字。选择承载故事的三个数字,其余的降级到附录或脚注中。
  • 为每个数字提供上下文。 百分比变化、基线、时间范围。
  • 突出要点 - 在图表上标注,淡化其余部分,将视线吸引到重要的地方。

写作规则

  • 以洞察开头,而非方法论。
  • 将统计数据转化为通俗语言和人类利益相关的内容。
  • 使用比较和类比来让读者感受到量级(“足以填满两次场馆”)。
  • 诚实地对待不确定性和局限性——可信度是全部关键。
  • 不要选择性挑选;讲述真实的故事,包括不方便的数据。

反模式

  • 倾倒所有指标,让读者自行寻找要点。
  • 使用标签而非发现作为图表标题。
  • 没有比较或上下文的数字。
  • 从相关性过度宣称因果性。
  • 在方法论下埋没关键信息。

质量标准

  • 标题发现是一个包含一个数字的单句,并且可以独立存在作为整个故事。
  • 每个图表标题都陈述一个发现,而非标签,并且通过五秒钟测试。
  • 每个数字都有一个比较点(基线、基准或前期)和一个时间范围。
  • 没有任何因果主张仅依赖相关性,并且每个小样本百分比都显示其原始计数。
  • 推荐行动指明了受众中某人可以实际做出的决策。

输出

交付数据故事:顶部放置标题发现,然后是支持性趋势、含义和推荐行动。对于每个图表,给出一个以发现为导向的标题,并注释需要突出显示的内容。标记数据无法完全支持的任何结论,以免过度陈述。

Individual skills in this repo

This repo contains 19 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

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

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

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer 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

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

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

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

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.

相关技能