Token导航 LogoToken导航

Agent Skill · 研究检索

storytelling-with-data(用数据讲故事)

用于辅助数据整理、表格处理、CSV/Excel 分析、指标计算和图表准备。它适合让 Agent 清洗字段、汇总数据、发现异常、生成统计口径或把分析结果转成可读说明。使用时需要确认数据来源、字段含义和时间范围,避免把样本数据当全量事实;涉及敏感数据、导出文件或批量写回时,应先确认权限和脱敏边界。

storytelling-with-data 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 48,372。

总安装 692周安装 28GitHub Stars 125下载 217核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:storytelling-with-data(用数据讲故事)
来源仓库:https://github.com/sammcj/agentic-coding
仓库路径:skills/storytelling-with-data
安装命令:
npx skills add https://github.com/sammcj/agentic-coding --skill storytelling-with-data
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/sammcj/agentic-coding --skill storytelling-with-data

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

用于辅助数据整理、表格处理、CSV/Excel 分析、指标计算和图表准备。它适合让 Agent 清洗字段、汇总数据、发现异常、生成统计口径或把分析结果转成可读说明。使用时需要确认数据来源、字段含义和时间范围,避免把样本数据当全量事实;涉及敏感数据、导出文件或批量写回时,应先确认权限和脱敏边界。

通过 npx skills add 命令从指定 GitHub 仓库安装,具体路径为 skills/storytelling-with-data。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/storytelling-with-data

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/sammcj/agentic-coding --skill storytelling-wit…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

storytelling-with-data 怎么安装?

在终端执行 npx skills add https://github.com/sammcj/agentic-coding --skill storytelling-with-data。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

storytelling-with-data 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

storytelling-with-data 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

storytelling-with-data 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

storytelling-with-data 用的人多吗?

公开数据是累计安装 692 次,近一周安装 28 次,下载 217 次,GitHub 125 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

storytelling-with-data 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
storytelling-with-data

用数据讲故事 · 本页

692125只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Storytelling with Data (SWD) Skill

Apply the 6-lesson framework from Cole Nussbaumer Knaflic's *Storytelling with Data* methodology when creating, reviewing, or improving any data communication: charts, dashboards, infographics, slide decks, static sites, or written reports.

When to Use This Skill

  • Creating: Building new visualisations, dashboards, infographics, presentations, or data-driven pages
  • Reviewing: Critiquing existing data communications for clarity and impact
  • Improving: Performing "makeovers" on charts, dashboards, or layouts to make them more effective
  • Advising: Helping the user choose the right chart type, structure a narrative, or declutter
Format-agnostic by design: This skill covers *what* to communicate and *how* to design it. Pair it with format-specific skills or tools that handle the output mechanics (e.g. a pptx skill for slide decks, a web framework for interactive dashboards, an SVG/image tool for infographics).

The SWD 6-Lesson Framework

Every data communication task should be evaluated against these 6 lessons, applied in order:

Lesson 1: Understand the Context

Before touching any tool, answer three questions:

  1. WHO is your audience? What do they care about? What's their relationship to you? What will motivate them?
  2. WHAT do you need them to know or do? Define the single action or takeaway.
  3. HOW will you communicate? Live presentation? Email? Dashboard? This changes everything about design.

Key techniques:

  • The 3-Minute Story: Can you explain your entire message in 3 minutes? If not, you haven't distilled it enough.
  • The Big Idea: One sentence that articulates your unique point of view, what's at stake, and what you want the audience to do. Format: [situation] + [complication] → [recommended action].
  • Storyboard first: Sketch your flow on sticky notes or paper before opening any tool. Rearrange freely.
  • Exploratory ≠ Explanatory: The audience sees only the *explanatory* output - the curated insight, not the full analysis journey. Never dump exploratory analysis on your audience.

When reviewing existing work, ask:

  • Is there a clear "so what?" on every chart, panel, or section?
  • Could the audience state the key message after a 3-second glance?
  • Is there a specific call to action?

Lesson 2: Choose an Appropriate Visual Display

Match the visual to the message. You can handle the vast majority of business communications with just a few chart types.

Read references/chart-selection.md for the detailed chart selection guide.

Quick decision framework:

  • Comparison across categories → Horizontal bar chart (default workhorse)
  • Trend over time → Line chart (continuous) or vertical bar chart (discrete periods)
  • Part-to-whole → Stacked bar or waterfall (NOT pie charts)
  • Two data points comparison → Slopegraph
  • Single important number → Simple text (the number itself, large, with context)
  • Detailed lookup → Table or heatmap

Charts to AVOID:

  • Pie and doughnut charts (hard to compare areas/angles accurately)
  • 3D anything (adds clutter, distorts data, makes reading values harder)
  • Dual y-axes (confuse the audience about scale relationships)
  • Spaghetti graphs (too many overlapping lines - filter or use small multiples instead)

Lesson 3: Eliminate Clutter

Clutter is any visual element that takes up space without adding understanding. Every element increases cognitive load - the mental effort to process information.

Identify and remove:

  • Chart borders and unnecessary outlines
  • Gridlines (reduce to light or remove entirely)
  • Data markers on every point (only mark what matters)
  • Redundant labels (if the axis says it, the data label doesn't need to)
  • Bold/italic/colour on everything (when everything is emphasised, nothing is)
  • Legends (can you label directly instead?)
  • Rotated text (hard to read - restructure the chart instead)
  • Decorative elements that don't encode data

Apply Gestalt Principles to structure what remains:

  • Proximity: Group related items close together; separate unrelated ones
  • Similarity: Use consistent colours/shapes for items in the same category
  • Enclosure: Subtle backgrounds can group related content
  • Closure: Remove unnecessary borders - the eye fills in gaps
  • Continuity: Align elements so the eye flows naturally
  • Connection: Lines connecting points imply sequence or relationship

Decluttering process (step by step):

  1. Remove chart borders
  2. Remove or lighten gridlines
  3. Remove data markers (unless specific points need emphasis)
  4. Clean up axis labels (round numbers, remove unnecessary precision)
  5. Label data directly (eliminate legends where possible)
  6. Use consistent, strategic colour

Lesson 4: Focus Your Audience's Attention

Use preattentive attributes - visual properties the brain processes before conscious thought - to guide the eye to what matters:

  • Colour: The most powerful tool. Use a single accent colour to highlight the key data; push everything else to grey. Never use colour decoratively.
  • Size: Larger elements draw attention first. Make the key number or data point bigger.
  • Position: Items at the top-left get seen first (in left-to-right reading cultures). Place the most important information there.
  • Bold/weight: Use sparingly on text to create hierarchy. Bold the key phrase, not the whole paragraph.

The Grey + One Colour rule: Default everything to grey, then use ONE strategic accent colour to highlight the story. This is the single most impactful SWD technique.

Memory matters:

  • Iconic memory (~0.5 seconds): Preattentive attributes are processed here - that's why colour and size pop instantly
  • Short-term memory (~4 items): Don't overload a single view with too many competing elements
  • Long-term memory: Connect to what the audience already knows - use familiar chart types and conventions

Lesson 5: Think Like a Designer

Design serves the message. Apply these principles:

  • Form follows function: Every element earns its place by serving comprehension
  • Affordances: Make interactive elements look clickable; make important text look important
  • Accessibility: Would this work in greyscale? For colour-blind audiences? Without a narrator explaining it?
  • Aesthetics build trust: Clean, well-aligned visuals signal competence and credibility

Practical design rules:

  • Use consistent alignment (create an invisible grid)
  • Left-align text (easier to read than centred for body content)
  • Use white space generously - it's not wasted space, it's breathing room
  • Limit fonts to 1-2 families; use size and weight for hierarchy
  • Action titles > descriptive titles: "Revenue grew 23% in Q3" beats "Q3 Revenue"
  • Every chart, section, or panel should have a clear, declarative title that states the "so what"
  • Add context with text annotations directly on the visualisation

Lesson 6: Tell a Story

Structure your communication as a narrative arc:

  • Beginning (Setup/Plot): Establish the situation - what does the audience need to know as background? Build common ground.
  • Middle (Conflict/Tension): This is the complication - the problem, the change, the unexpected finding. This is where data creates tension between "what we expected" and "what is actually happening."
  • End (Resolution/Call to Action): The recommendation. What should the audience DO with this information?

Storytelling techniques:

  • Repetition: Repeat your key message at least 3 times in different ways
  • Sequential logic: Read just the section or chart titles in order - they should tell a complete story on their own. In a slide deck this is "horizontal logic" (reading slide titles across). In a dashboard or infographic, it's the reading order of panels or sections top-to-bottom.
  • Self-contained units: Each individual section, panel, or slide should make sense on its own with its title + content ("vertical logic" in presentation terms).
  • Match the medium: If presenting live, visuals should be sparse (you are the narrator). If the output will be consumed without a presenter (dashboards, emailed reports, embedded infographics), it needs more text, annotation, and self-explanatory context.
  • Build/reveal progressively: Don't show everything at once. In presentations, build up the visual piece by piece. In interactive formats (dashboards, web pages), use progressive disclosure - overview first, detail on demand.

Applying SWD: Task-Specific Workflows

Creating New Data Communications

This workflow applies regardless of output format (slide deck, dashboard, infographic, static site, report).

  1. Context interview - Ask the user: Who's the audience? What's the one thing they should take away? What format/medium will this be consumed in?
  2. Storyboard - Draught section or panel titles as a narrative arc (beginning, tension, resolution). For presentations, these become slide titles. For dashboards, these become panel headings. For infographics, these become section headers.
  3. Chart selection - For each data point, pick the simplest effective chart (see references/chart-selection.md)
  4. Build - Apply Lessons 3-5 while creating each section or view
  5. Review - Check sequential logic (titles in order tell the story) and that each unit is self-contained

Format-Specific Considerations

FormatKey adaptations
Slide deckSparse visuals (presenter narrates), one idea per slide, progressive build/reveal
DashboardSelf-explanatory (no presenter), overview panels first with drill-down detail, interactive filters to reduce clutter
InfographicSingle linear flow top-to-bottom, strong visual hierarchy to guide the eye, must stand alone without explanation
Static site / playgroundProgressive disclosure (summary up top, detail below or on click), responsive layout considerations, can use animation/interaction for reveal
Written reportMore annotation and explanation than visual formats, charts support the narrative text rather than replace it

Reviewing / Critiquing Existing Work

Run through the SWD Review Checklist in references/review-checklist.md. For each chart, panel, section, or slide, evaluate against all 6 lessons and provide specific, actionable feedback.

Chart / Visualisation Makeover

  1. Identify the core message (what should the audience think/do?)
  2. Choose a better chart type if needed (Lesson 2)
  3. Strip all clutter (Lesson 3)
  4. Apply grey + accent colour strategy (Lesson 4)
  5. Add a declarative action title (Lesson 5)
  6. Add text annotations to guide interpretation (Lesson 5)
  7. Show before/after to demonstrate the improvement

Reference Files

FileWhen to read
references/chart-selection.mdWhen choosing a chart type or advising on visual selection
references/review-checklist.mdWhen reviewing or critiquing existing data communications
references/colour-and-emphasis.mdWhen making colour choices or applying emphasis strategies

平台分布

Codex

34.99%
按下载量换算76

Claude

31.51%
按下载量换算68

Cursor

20.5%
按下载量换算44

Gemini CLI

10.6%
按下载量换算23

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills