Chart Storytelling
将数据分析转化为图文结合、便于分享的 HTML 数据故事或 Web-PPT。 适用于制作分析报告、业务简报和数据专题,尤其适合图表滚动叙事:随滚动逐步呈现数据与解读, 配合图表标注突出关键数据、变化和结论,帮助受众理解趋势、差异与构成;也支持网页演示。
Install
npx skills add VisActor/skills --skill chart-storytellinggit clone --depth 1 https://github.com/VisActor/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/chart-storytelling ~/.claude/skills/chart-storytellingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 图表叙事(Chart Storytelling)
以图表组织证据,使用预设章节模式将数据分析转化为 HTML 故事或 Web-PPT,先产出可跨产物复用的 `plan.md`,再由对应的 build 模块生成具体产物。核心架构:**共享叙事设计(Phase 1-3)+ 按产物执行 Build(Phase 4)**。
## 核心定义
Data Story = **Data**(洞察证据)+ **Narrative**(认知路径)+ **Visuals**(视觉呈现)
数据叙事不是"把分析结果视觉化",而是把三者组合成一个让特定受众更快理解、更容易决策的产品。
真正的数据故事必须同时回答:
1. 读者最关心什么问题?
2. 哪些证据足以回答这个问题?
3. 页面如何安排顺序,让读者几乎不需要"自我翻译"就能看懂?
---
## 架构概览
```
Phase 1-3(共享叙事核心)
理解 → 数据分析 → 叙事设计
↓
plan.md
故事元信息 + 证据骨架 + 章节基础结构 + 样式选择
↓
用户确认 plan.md
↓
Phase 4: Build(按目标产物加载对应 build 模块)
↓
build-html/ | build-ppt/
↓
具体产物
```
---
## 运行环境
Python 3.10+ 用于随附的标准库脚本,Node.js 用于 JavaScript 语法校验;浏览器需能访问公开 unpkg CDN。当前 Agent 负责读取数据、推理和生成 VSeed 配置,不需要 VisActor 托管模型服务。普通图表使用 VSeed 0.6.5、VChart 2.1.7 与 VTable 1.26.8;HTML 动效使用 GSAP 3.15.0。图片生成是可选宿主能力,不可用时按 Plan 执行并披露 fallback。Web-PPT 输出 HTML,不输出 `.pptx`。
`runtime/` 表示用户项目的产物目录;在评测或要求统一输出时使用 `outputs/runtime/`。`$SKILL_DIR` 必须指向安装后的完整 Skill 目录。不要改写已安装的 Skill。
若用户已明确授权端到端生成,可记录假设与计划后直接进入 Build;否则在计划阶段进行一次确认。
## 工作流
### Phase 1: 理解与定义
在一次集中提问里拿齐以下信息:
1. **受众** — 读者是谁?看完后需要理解什么、做什么决策?
2. **核心问题** — 这篇故事试图回答哪个问题?
3. **整体风格** - 这篇故事用什么风格(视觉/语气)来展示?
4. **可用数据** — 现有数据、分析产物、图片各有哪些?
5. **约束** — 发布场景、时间范围
如果关键信息缺失但风险可控,显式写出假设后继续推进。
### Phase 2: 数据分析与洞察发现
先分析数据,再设计故事。这是最关键的一步。
1. **盘点输入** — 表格、截图、报告、图像、已有文案
2. **检查可靠性** — 时间范围、粒度、样本量、缺失值、口径变化
3. **找到 3-5 个发现**,标记 insight 类型:
- **趋势**: 某事正在上升、下降或周期性变化
- **异常**: 某事出乎意料地高、低或不同
- **对比**: 两个实体在有意义的方面不同Details
- Skill name
chart-storytelling- Repository
- VisActor/skills
- Path
skills/chart-storytelling/SKILL.md- License
- MIT
- Repo updated
- 17 November 2026
FAQ
What does the Chart Storytelling skill do?
将数据分析转化为图文结合、便于分享的 HTML 数据故事或 Web-PPT。 适用于制作分析报告、业务简报和数据专题,尤其适合图表滚动叙事:随滚动逐步呈现数据与解读, 配合图表标注突出关键数据、变化和结论,帮助受众理解趋势、差异与构成;也支持网页演示。
How do I install the Chart Storytelling skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add VisActor/skills --skill chart-storytelling. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Chart Storytelling popular?
It lives in VisActor/skills, which has 489 GitHub stars and 89 forks.
Related skills
Chart Assistant
489VisActor/skills
创建、编辑、解释和交付图表助手可编辑图表与配置;支持内置及商务图表、KPI、分析标注、MBB制图、参考图片还原、Sheet/Base/风神来源同步、飞书图表卡片和PNG交付。用户提到图表助手、可编辑图表/配置/卡片、内置模板、来源同步、用风神或Sheet/Base链接建图、MBB/咨询风或参考图还原时使用。普通“画图/画趋势”而未要求这些产品能力时不主动接管;只问文字解释时不进入建图流程。
Creative Data Storytelling
489VisActor/skills
将数据、文本档案或研究发现制作成面向公众的交互式数据故事。围绕读者追问组织证据与叙事,设计数据关系的可视化表达及前后衔接,结合连续舞台、自然阅读和按需探索,完成数据故事的研究、设计、实现与修订。
Editorial Magazine
489VisActor/skills
用 HTML/CSS 制作小红书、抖音的杂志图文,支持新闻资讯、人物生平、穿搭解析、旅行攻略、时序故事、观点解读与概念科普。按场景模板生成可编辑 HTML 与 PNG;穿搭优先使用用户照片,制作统一中性背景的多套组合与单套拆解组图。
Visactor Chart Editor
489VisActor/skills
创建轻巧易用的图表编辑器,拖拽字段、切换图型,即时查看数据。适用于自助制图和数据探索。Powered by VisActor。
Visactor Light Dashboard
489VisActor/skills
创建支持业务判断与进一步分析的小而美的 Dashboard,适用于经营概览、指标监测和专题分析。Powered by VisActor。
Data Analysis
381DougTrajano/pydantic-ai-skills
Profile and aggregate a bundled sales dataset - group revenue by region, category, channel or month, apply filters, and compute sums, means, medians and ranges. Use for questions about sales figures, trends, or which segments perform best.
Browse the most popular Claude skills, all data & analytics skills, or write your own with the skills generator.