1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | tufte-claude-skill |
| 作者/维护者 | Aref(FalconHQ 联合创始人,GitHub 个人开发者) |
| 来源链接 | https://github.com/aref-vc/tufte-claude-skill |
| 许可证 | MIT(GitHub API 获取) |
| GitHub Stars | 278(GitHub API 获取) |
| Forks | 26(GitHub API 获取) |
| 最新版本 | 无正式 Release/Tag(滚动更新),最近一次提交 2026-06-15(GitHub API 获取) |
| 安装方式 | git clone 到 ~/.claude/skills/ 目录 |
2. 功能介绍与亮点
tufte-claude-skill 把统计学家 Edward Tufte 的三本经典著作(《The Visual Display of Quantitative Information》《Envisioning Information》《Visual Explanations》)蒸馏成十条可执行的图表设计原则,让 agent 在被要求“做个图表”时自动套用这套规则,而不是输出默认的、常见的花哨图表。
核心工作流程分五步:读取 principles.md 记住十条原则 → 依据 chart-selection.md 按数据形状与目的选图表类型 → 套用 kill-list.md 剔除不该出现的元素(3D、饼图、双轴、彩虹色阶、边框等)→ 按用户偏好输出自包含 HTML/SVG 或 React(Recharts + D3)代码 → 生成前跑一遍 checklist.md 的十二项终检。
主要亮点:
- 方法论完整:十条原则均标注 Tufte 原著出处与页码,不是泛泛而谈的“简洁美观”。
- 九组前后对比:仓库内
before-after.html提供可交互的九组真实场景对比(KPI 看板、时间序列、漏斗图、队列留存等),直观展示改造效果。 - 可打印速查表:
cheatsheet.html/cheatsheet.pdf把十条原则、Lie Factor 公式、图表选型表、剔除清单浓缩进一页。 - 允许用户override:用户明确要求“不合规”的图表(如“CFO 要看饼图”)时会照做,但会附一句 Tufte 替代方案提示,不会强行拒绝。
3. 适用场景
固定分类:数据分析与可视化。
适合任何需要 agent 生成或改造图表、看板、KPI 卡片的场景——数据分析师做汇报图、产品经理做增长看板、内容创作者给文章配图表。目标用户是已经在用 Claude Code 生成图表、但对默认输出的“AI 味”图表(彩虹配色、3D 效果、冗余图例)不满意的初中级用户,无需额外学习设计理论即可获得专业级视觉效果。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持,README 明确要求安装到
~/.claude/skills/,并提供/tufte专用斜杠命令。 - Codex:❓ 未验证,已抓取材料未提及 Codex 安装路径或兼容性说明。
- OpenClaw:❓ 未验证,已抓取材料未提及。
- Hermes Agent:❓ 未验证,已抓取材料未提及。
(判断依据:以上结论均来自已抓取的 README 与 SKILL.md,未为兼容性单独发起搜索。)
5. 推荐理由
这个技能把“图表要好看”这件模糊的审美要求,变成了一套可执行、有出处、可终检的具体规则,装好之后不需要用户懂设计理论,就能让 agent 默认产出专业分析师水准的图表,而不是常见的花哨默认样式。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 278 Stars,仓库创建于 2026-05-23,约两个月内积累至此,近一月增长显著;第三方趋势聚合站 trendshift.io 亦收录该项目,独立开发者曾在 X 平台分享使用体验,形成一定独立讨论 |
| 可用性 | 9 | 单条 git clone 命令即可安装,无需额外依赖或付费 API;文档体系完整(README + SKILL.md + 原则/选型/剔除清单/终检清单 + 可打印速查表),并附九组真实前后对比图;最近一次提交 2026-06-15 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
- Shell 命令及权限范围:无 Shell 命令执行,技能仅输出 HTML/SVG 或 React 代码文本,不调用 Bash 工具。
- 联网外发:无网络请求,全部内容为本地 Markdown 规则文件与静态代码生成指导。
- API key/凭据:不需要任何 API Key 或凭据。
- 可疑指令:审查 SKILL.md 及全部引用的
principles.md、kill-list.md、checklist.md等文件,均为图表设计规则本身,未发现要求 agent 执行额外操作、访问文件系统之外内容或外发数据的可疑指令。 - 作者/组织信誉:作者 Aref 为 FalconHQ 联合创始人,GitHub 身份可查(账号创建于 2025-07-15,36 个公开仓库),非匿名账号,但非知名机构出品。
- License:MIT,明确。
- 最近维护时间:最近一次代码推送 2026-06-15,距今约 5 周,非弃置项目。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 tufte-claude-skill 的差异 |
|---|---|---|
| caylent/tufte-data-viz | 同样基于 Tufte 原则的图表技能,覆盖 Recharts、ECharts、Chart.js、matplotlib、Plotly、D3/SVG 多套图表库,提供在线交互演示页 | 图表库覆盖面更广、通过 npx skills add 分发,但仓库自 2026-02-19 起再无提交更新;tufte-claude-skill 输出栈仅限 HTML/SVG 与 React(Recharts+D3),但配套了十二项终检清单与九组对比案例等更完整的方法论文档,且近期仍有迭代 |
| Dsadd4/AgentFigureGallery | 科学绘图参考图库技能,agent 从 16,000+ 篇论文配图数据集中检索参考图,用户在浏览器中标记喜欢/拒绝后导出参考包指导绘图 | 走“以真实论文配图为参照”的路线,更适合科研绘图场景,但安装需要 Python 虚拟环境与本地服务;tufte-claude-skill 走“内置设计规则直接生成”的路线,安装只需一条 git clone,更适合日常业务图表场景 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价;曾有独立开发者在 X 平台提及使用该技能后图表变得更简洁美观,但该内容未能通过直接抓取验证,故不作为已核实评价收录。
9. 其他补充
- 仓库同时提供
presets/html-svg.md与presets/react.md两套预设样式代码模板(含 SVG 组件示例、Recharts 主题、D3-in-React 图案),可直接复用。 - README 明确欢迎社区贡献新的前后对比案例,以及 Python(matplotlib/plotly)、Observable Plot、Vega-Lite、ggplot2 等其他技术栈的输出预设,但新增图表类型需先开 Issue 讨论。
10. 安装使用方式
- 安装:
git clone https://github.com/aref-vc/tufte-claude-skill.git ~/.claude/skills/tufte,Claude Code 下次启动会自动加载。 - 更新:
cd ~/.claude/skills/tufte && git pull。 - 卸载:
rm -rf ~/.claude/skills/tufte。 - 触发方式:直接对 Claude 提出图表相关需求(如“帮我做一张月活趋势图”)即可自动触发,也可用
/tufte显式调用,或直接提及“Tufte”。可通过说明“要 React 版本”或“要 D3”指定输出技术栈,默认输出自包含 HTML/SVG。 - 安装后注意事项:需重启 Claude Code 一次以确保技能被正确加载;若要重新生成
cheatsheet.pdf,需额外安装 Python 包weasyprint,但该步骤非必需,仓库已自带生成好的 PDF。
11. 注意事项
- 默认严格执行 Tufte 规则(禁用饼图、3D、双轴等),如确实需要这些“不合规”图表类型,需在需求中明确说明,否则 agent 会按默认规则替换为它认为更合适的图表。
- 目前仅明确支持 Claude Code,未提供 Codex、OpenClaw、Hermes Agent 的安装说明或兼容性声明。
- 仓库未开启常规 Issue 讨论区(仅限维护者创建 Issue),社区反馈渠道有限,长期维护的持续性尚待观察。
- 输出的 React 预设基于 Recharts + D3,若项目使用其他图表库(如纯 ECharts 或 Chart.js 项目),需要自行迁移代码而非直接复用预设模板。