data-storytelling SKILL.md skillA
data-storytelling from visactor/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add visactor/skills/data-storytelling@git:20261014.a082aa4Pins git:20261014.a082aa4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- visactor/skills
- Path
skills/data-storytelling/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261014.a082aa4, committed Oct 14, 2026
- First version recorded
- Oct 10, 2026
- Size
- 34,447 bytes
- Repository stars
- 471
- License
- MIT
将数据转化为叙事驱动的数据故事计划，并按目标产物生成对应作品。 当用户想用数据讲故事、创建数据叙事、做 scrollytelling、制作数据报告、展示分析结果、或将数据变成有说服力的视觉传播时使用此 skill。 也适用于用户说"解释这些数据"、"让数据有说服力"、"可视化分析结果"、"数据叙事"、"data storytelling"，或想把分析结果变成可分享的数据作品。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Data Storytelling
将原始数据转化为有说服力的叙事驱动视觉故事，先产出可跨产物复用的 `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。API harness 的 `run_skill_script` 接受根 scripts 下的文件名，或 `build-html/scripts/prepare_story_head.py` / `build-ppt/scripts/prepare_story_head.py` 这两个相对路径；参数是 argv 数组。
若用户已明确授权端到端生成，可记录假设与计划后直接进入 Build；否则在计划阶段进行一次确认。
## 工作流
…Read the whole file at its exact version.
How to install
mdr add visactor/skills/data-storytelling@sha256:ce56fb964b275b38The line at the top of this page pins the label git:20261014.a082aa4, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fzejeam3cqwda42g)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Oct 10, 2026 and Oct 14, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261014.a082aa4 latest | 2026-10-14 | a082aa4 | 34,447 B | A | view · diff |
| git:20261010.5ff1d03 | 2026-10-10 | 5ff1d03 | 34,103 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (34447 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
visactor/skills · 471 stars · license MIT · pushed 2026-10-20 · branch develop
API
GET https://markdownregistry.com/api/v1/artifacts/art_fzejeam3cqwda42g GET https://markdownregistry.com/api/v1/resolve?ref=visactor/skills/data-storytelling GET https://markdownregistry.com/api/v1/blob/ce56fb964b275b38bc7a1806d52e5865fc4ecda6e27d72052b2662720ae3b591
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.