skills/general/numbers/SKILL.md
Use when communicating quantitative information in any form — Slack updates, emails, reports, decks, dashboards, landing pages, product UI, public talks. Covers two integrated layers: (1) making numbers semantically meaningful (translation, anchoring, simplification, story-pairing) and (2) showing numbers cleanly (chart vs table vs prose, chart-by-message, pre-attentive emphasis, color discipline, decluttering). Distilled and integrated from *Show Me the Numbers* (Stephen Few) and *Make Numbers Count* (Chip Heath & Karla Starr). Not for raw data analysis or statistics — this is about communication of numbers, not their derivation.
npx skillsauth add beam-ai-team/beam-next-skills numbersInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
整合自 Stephen Few《Show Me the Numbers》与 Chip Heath & Karla Starr《Make Numbers Count》。 两本书的角色互补:
把它们合在一张工作台上,得到一条完整的链路: 受众 → 意义 → 形式 → 干净呈现 → 收尾解读。
在写任何含数字的内容前,先回答:
这一步是产出质量的最大杠杆。形式选错(图改成表,或反之),后面再多努力也救不回来。
人脑没进化出处理大数字的能力。我们天然处理的是 1、2、3、很多。任何"亿、百分、毫秒、纳米"都需要翻译。
数字看起来严谨,但常常掩盖意义。读者看到 23% YoY,不知道这是好是坏,要费脑力跨级比较。
判断标准:把数字删掉,意思还在吗?还在,就删。 保留数字的合法理由通常只有:精确决策、合规留痕、对比要算账。
人能"抓住"的精度比人愿意呈现的精度低得多。
| 原数字 | 抓得住的版本 | |---|---| | 89.7% | 9 in 10 / 接近九成 | | 1,247,856 | 约 125 万 / "破百万" | | 2.7× | 接近 3 倍 / "翻三倍" | | 33.4% | 1/3 | | 49.6% | 「一半」 |
默认偏好:
例外:财务、合规、医学剂量等场合,精度本身就是信息,不能简化。
漂在空中的数字没有重量。要把它系在读者熟悉的物体、时间、空间上。
经典锚的库(背下来当肌肉记忆):
| 维度 | 锚 | |---|---| | 时间 | 1 百万秒 ≈ 12 天;1 十亿秒 ≈ 32 年 | | 钱 | 一杯咖啡 $5/天 ≈ $1,825/年 ≈ 22 年买一辆 Tesla | | 距离 | 地球周长 ≈ 4 万公里;LA → NY ≈ 4,000 公里 | | 人口 | 大型体育场 ≈ 8 万人;小城市 ≈ 10 万;旧金山 ≈ 80 万 | | 数据 | 一张照片 ≈ 3MB;一部 HD 电影 ≈ 4GB;国会图书馆全部文本 ≈ 15TB | | 体积/重量 | 一支黄油 ≈ 113g;一个篮球场 ≈ 420㎡ |
核心规则:
同一个事实,从不同维度讲,给人的感受完全不同。
切换的常见组合:
用法:先写出几个维度,挑那个 最贴你想让对方感受到的情绪 的。
大数字一次报出来麻木;让读者自己 数 出来,记忆和情绪都翻倍。
"想象一个房间里有 100 个人。其中 32 个……"
把"32%"改成上面这种 100 人剧场,读者会脑补画面。这是 Heath & Starr 反复强调的把抽象量"演出来"。
适用场景:演讲、长文开篇、产品故事页。
按规模递增地排列数字,对比触发"哇"。
"蛇每年杀 10 万人。狗 2.5 万。鲨鱼 6 个。蚊子?72.5 万。"
经典结构:从一个普通锚 → 类似量级 → 一个反直觉的更大量。
❌ "中位数家庭收入是 $75K。"
✅ "一半的家庭年收入在 $75K 以上,一半在以下。"
❌ "p < 0.05"
✅ 给非专家读者:直接说"这个差异不太可能是偶然"或省略。
让数字在视网膜到大脑这条管道里损耗最小。
| 形式 | 适用 | 信号 | |---|---|---| | 散文 | 1–3 个数字嵌在叙事里 | "增长翻倍(47 → 94 单)" | | 表格 | 精确查值;4+ 个值;多个单位/指标并列 | 读者要读出具体值 | | 图表 | 模式、趋势、对比、分布、相关性 | 读者要 看出形状 |
判断题:你想让读者「读」一个数字,还是「看出」一个形状?读 → 表格;看 → 图表。
每张图都在表达 其中一种 信息。先确定信息类型,再选图。不要从图样先选起。
| 信息类型 | 想说什么 | 推荐图 | 不要用 | |---|---|---|---| | 时间序列 Time-series | 一个量随时间变化 | 折线图(连续)/ 柱状(离散周期) | 饼图、雷达图 | | 排序 Ranking | 谁多谁少(已排序) | 横向条形图(按值排序) | 饼图、3D 柱状 | | 部分占总体 Part-to-whole | 一份占整体多少 | 条形图、堆叠条 | 饼图 ≥5 片;环图嵌套环图 | | 偏离 Deviation | 实际 vs 目标/基准 | 子弹图(bullet graph)、带参考线的条形 | 仅展示绝对值的图 | | 分布 Distribution | 值如何在区间分布 | 直方图、密度图、箱线图 | 折线连接频次 | | 相关性 Correlation | X 与 Y 的关系 | 散点图(必要时加趋势线) | 双 Y 轴折线图 | | 名义对比 Nominal comparison | 多类无序对比 | 条形图(大→小排序) | 饼图、词云 | | (地理)Geospatial | 地理分布 | choropleth / 点地图 | 3D 地球仪 |
核心 mantra:信息类型 → 图类型。不要反过来。
人脑在 200ms 内并行处理这些视觉特征:位置、长度、宽度、大小、方向、形状、闭合、颜色色相、颜色明度、运动。
实操规则:
精度排序(从高到低):位置 > 长度 > 角度 > 面积 > 颜色明度 > 颜色色相。所以长度(条形)几乎永远胜过角度(饼图)。
颜色不是装饰,是一种带宽极窄的信道。乱用颜色 = 把高优先级带宽浪费在背景上。
颜色按用途分三种语义:
| 用途 | 配色规则 | |---|---| | 序列型(如收入档位) | 单一色相,明度从浅到深 | | 分歧型(如盈亏,正负偏离) | 两个色相从中点分开(蓝↔红、青↔橙) | | 类别型(如不同地区) | 最多 6 个色相;超过用位置/直接标签替代 |
自检:把图截图转灰度还能读出来吗?读不出来就重做。
不承载信息的元素:删,或淡。
Tufte 的 data-ink ratio 原则:每一滴墨水都该承载信息。
font-variant-numeric: tabular-nums; font-feature-settings: "tnum")。Few 的核心主张:dashboard 是"重要信息一屏可见",不是数据百货。
有结论可讲?
├─ 是 → 数字能让结论更可信/可决策吗?
│ ├─ 能 → 保留 1–3 个,按 Rule 2 简化、Rule 3 锚定
│ └─ 不能 → 删
└─ 否 → 先想结论,再回来
读者要做的动作:
├─ 读出具体值 → 表格
├─ 看出形状/趋势/对比 → 图表(按 Rule 10 选)
├─ 记住一个结论 → 散文 + 1 个被锚定的数字
└─ 既要看形状又要查值 → 图表为主 + 可展开的表格
| 问题 | 答 yes 用 | |---|---| | 是不是随时间变化? | 折线图 | | 是不是分类间排序对比? | 横向条形图 | | 是不是部分占整体?(≤4 类) | 条形 / 环图 | | 是不是「实际 vs 目标」? | bullet graph | | 是不是值的分布? | 直方图 / 箱线图 | | 是不是 X-Y 关系? | 散点图 | | 都不是,纯类别比较? | 条形图 |
如果以下任意为真,返工:
"Q1 营收 $4.2M(vs Q4 的 $3.1M,行业平均 +5% 我们 +35%)"
prefers-reduced-motion。aria-live 通知。每次出货前过一遍:
| 维度 | 锚 | |---|---| | 时间 | 1M sec ≈ 12 天;1B sec ≈ 32 年 | | 钱 | 日 $5 ≈ 年 $1,825 ≈ 10 年 $18K | | 距离 | 地球周长 ≈ 40,000 km;马拉松 ≈ 42 km | | 人口 | 体育场 ≈ 8 万;旧金山 ≈ 80 万;新加坡 ≈ 600 万 | | 数据 | 照片 ≈ 3MB;HD 电影 ≈ 4GB;GPT-4 训练数据 ≈ TB 级 | | 速率 | 阅读速度 ≈ 250 词/分钟;正常步行 ≈ 5 km/h | | 概率 | 1 in 1M ≈ 一年内被雷击的概率 | | 体积/重量 | 一支黄油 ≈ 113g;一颗鸡蛋 ≈ 50g;篮球场 ≈ 420㎡ |
替代仪表盘 gauge,用更少像素表达更多信息。
poor satisfactory good
█▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░
━━━━━━━━━━━━━━━━━ ← actual (深色窄条)
│ ← target (短竖线)
0 50 100
构成:
数据密度约为 gauge 的 10×。
意义层(Heath & Starr)
视觉层(Few)
通用纪律
prefers-reduced-motion 永远遵守。development
--- name: taste-skill type: skill version: '1.0' author: Leonxlnx (packaged by Zhichao Li) category: general tags: - frontend - design - anti-slop - landing-page updated: '2026-06-11' visibility: public description: Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check. license: MIT.
development
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
tools
Stateful multi-session tutor adapted for Beam — teach a stakeholder to understand, trust, and operate a specific agent, or teach a Solution Engineer a client's business process for delivery. Grounds every lesson in Knowledge Hub sources (real agent graphs, real tasks, transcripts, Linear) before any web resource. Also works for any general topic. Trigger on "teach me", "beam teach", "教我", "onboard <person> on <agent>", "help <stakeholder> understand the agent", "learn this client's process".
development
Audit a Beam agent for hallucination risk using interrogation-science techniques — check prompts, input/output schemas, node boundaries, and (when available) real task evidence; then recommend prompt fixes, schema fixes, and graph-level additions (Code Executor validators, LLM cross-examiner nodes, abstention routing). STRICTLY READ-ONLY — never modifies, publishes, or deploys; output is an audit report with ranked recommendations. Load when user says "audit this agent for hallucination", "why is this agent extracting wrong data", "check this prompt for hallucination risk", "reduce hallucination", or shows correction/complaint data from a production agent.