Chart Storytelling

将数据分析转化为图文结合、便于分享的 HTML 数据故事或 Web-PPT。 适用于制作分析报告、业务简报和数据专题,尤其适合图表滚动叙事:随滚动逐步呈现数据与解读, 配合图表标注突出关键数据、变化和结论,帮助受众理解趋势、差异与构成;也支持网页演示。

489 stars 89 forksData & Analytics

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add VisActor/skills --skill chart-storytelling
Manual install
git 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-storytelling

Personal 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 类型:
   - **趋势**: 某事正在上升、下降或周期性变化
   - **异常**: 某事出乎意料地高、低或不同
   - **对比**: 两个实体在有意义的方面不同
Read the full skill on GitHub

Details

Skill name
chart-storytelling
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

489

VisActor/skills

创建、编辑、解释和交付图表助手可编辑图表与配置;支持内置及商务图表、KPI、分析标注、MBB制图、参考图片还原、Sheet/Base/风神来源同步、飞书图表卡片和PNG交付。用户提到图表助手、可编辑图表/配置/卡片、内置模板、来源同步、用风神或Sheet/Base链接建图、MBB/咨询风或参考图还原时使用。普通“画图/画趋势”而未要求这些产品能力时不主动接管;只问文字解释时不进入建图流程。

Data & Analytics89

Creative Data Storytelling

489

VisActor/skills

将数据、文本档案或研究发现制作成面向公众的交互式数据故事。围绕读者追问组织证据与叙事,设计数据关系的可视化表达及前后衔接,结合连续舞台、自然阅读和按需探索,完成数据故事的研究、设计、实现与修订。

Writing & Content89

Editorial Magazine

489

VisActor/skills

用 HTML/CSS 制作小红书、抖音的杂志图文,支持新闻资讯、人物生平、穿搭解析、旅行攻略、时序故事、观点解读与概念科普。按场景模板生成可编辑 HTML 与 PNG;穿搭优先使用用户照片,制作统一中性背景的多套组合与单套拆解组图。

Writing & Content89

Visactor Chart Editor

489

VisActor/skills

创建轻巧易用的图表编辑器,拖拽字段、切换图型,即时查看数据。适用于自助制图和数据探索。Powered by VisActor。

Data & Analytics89

Visactor Light Dashboard

489

VisActor/skills

创建支持业务判断与进一步分析的小而美的 Dashboard,适用于经营概览、指标监测和专题分析。Powered by VisActor。

Data & Analytics89

Data Analysis

381

DougTrajano/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.

Data & AnalyticsIn 1 list29

Browse the most popular Claude skills, all data & analytics skills, or write your own with the skills generator.