Token导航 LogoToken导航

Agent Skill · 研究检索

bookforge-data-visualization-selector(bookforge 数据可视化选择器)

用于辅助数据整理、表格处理、CSV/Excel 分析、指标计算和图表准备。它适合让 Agent 清洗字段、汇总数据、发现异常、生成统计口径或把分析结果转成可读说明。使用时需要确认数据来源、字段含义和时间范围,避免把样本数据当全量事实;涉及敏感数据、导出文件或批量写回时,应先确认权限和脱敏边界。

bookforge-data-visualization-selector 是研究检索类 Agent Skill,可用宿主为 OpenClaw,通过ClawHub获取,权限为调用外部服务;许可证为 MIT-0,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 36,331。

总安装 1,944周安装 81GitHub Stars 公开资料未说明下载 648核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
MIT-0
版本
1.0.0

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:bookforge-data-visualization-selector(bookforge 数据可视化选择器)
来源仓库:https://github.com/quochungto/bookforge-data-visualization-selector
安装命令:
openclaw skills install bookforge-data-visualization-selector
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

ClawHubOpenClaw
openclaw skills install bookforge-data-visualization-selector

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

为数据集匹配合适的图表类型,增强信息传达效果。支持表格、柱状图、折线图等多种可视化形式的选择。基于数据类型、分析目标和受众特点推荐最佳呈现方式。输出结果包含图表设计和证据展示逻辑说明。bookforge-data-visualization-selector 属于研究检索类 Skill,可作为该场景下的辅助能力补充。

实际应用中需考虑色彩无障碍和响应式布局适配问题。

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 OpenClaw;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 openclaw skills install bookforge-data-visualization-selector;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要调用外部服务,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

bookforge-data-visualization-selector 怎么安装?

在终端执行 openclaw skills install bookforge-data-visualization-selector。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

bookforge-data-visualization-selector 支持哪些 AI 工具?

公开资料标注支持 OpenClaw。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

bookforge-data-visualization-selector 需要什么权限?

权限级别是调用外部服务。该 Skill 可能调用第三方服务、云服务或外部模型 API,使用前需要确认账号、额度、数据发送范围和服务条款。

bookforge-data-visualization-selector 是免费的吗?

来源标注的许可证是 MIT-0。本站不代收任何费用,也不托管安装包;能否商用、要不要署名,以许可证原文为准。

bookforge-data-visualization-selector 用的人多吗?

公开数据是累计安装 1,944 次,近一周安装 81 次,下载 648 次。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

bookforge-data-visualization-selector 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 专注 OpenClaw 一种宿主,触发方式和使用习惯不用来回切换。
  • 许可证明确为 MIT-0,商用和分发边界好判断。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 OpenClaw,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 需要许可证清楚、并且有第三方扫描结果的团队项目。

不太适合

  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
bookforge-data-visualization-selector

bookforge 数据可视化选择器 · 本页

1,944—调用外部服务MIT-0通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

name
data-visualization-selector
description
Select the correct graphic type (table, bar chart, line graph) for a dataset and rhetorical goal, then design and frame it to communicate evidence clearly and honestly. Use this skill whenever the user needs to present quantitative data in a research paper, report, thesis, presentation, or professional document and asks: which chart should I use, how should I visualize this data, how do I make this graphic clearer, is my chart misleading, how do I label or title a table or figure, or how do I introduce a graphic in text. Also triggers on: \"my advisor said the table is confusing,\" \"should I use a bar chart or line graph,\" \"how do I make readers see my point in this figure,\" \"is this graph ethical,\" \"my chart looks amateurish,\" \"the scale on my graph looks off,\" or any request to improve the visual communication of numerical evidence. Covers the full workflow: verbal-vs-visual decision → graphic type selection based on rhetorical effect → design simplification → framing with title, intro sentence, and labels → ethical integrity checks.
version
1.0.0
homepage
https://github.com/bookforge-ai/bookforge-skills/tree/main/books/the-craft-of-research/skills/data-visualization-selector
metadata
{"openclaw":{"emoji":"📚","homepage":"https://github.com/bookforge-ai/bookforge-skills"}}
status
draft
source-books
title
The Craft of Research, 4th Edition
authors
["Wayne C. Booth", "Gregory G. Colomb", "Joseph M. Williams", "Joseph Bizup", "William T. FitzGerald"]
chapters
[15]
tags
[research-methodology, data-visualization, academic-writing, evidence-presentation, tables, charts, graphs, research-ethics]
depends-on
[]
execution
tier
1
mode
hybrid
inputs
description
The dataset, table, or graphic the user wants to present or improve — pasted as text, described verbally, or provided as a file
description
The argument or point the graphic is meant to support — what readers should conclude from it
tools-required
[]
tools-optional
[Read, Write]
mcps-required
[]
environment
Any agent environment. Works on described data, pasted tables, or referenced files.

Data Visualization Selector

When to Use

The user has quantitative data and needs to present it visually in a research paper, report, thesis, or presentation. Typical triggers:

  • User has a dataset and asks "should I use a table or a chart?"
  • User shares an existing graphic and asks why it looks confusing or amateurish
  • User asks how to title, label, or introduce a graphic
  • An advisor or reviewer said a figure was misleading, hard to read, or poorly framed
  • User has multiple data points they are struggling to fit into prose
  • User suspects their chart may be exaggerating or misrepresenting their findings

Scope: This skill covers the selection, design, and ethical framing of tables, bar charts, and line graphs — the three graphic types essential for basic quantitative research. For scatter plots, heat maps, box plots, or advanced statistical graphics, use this skill's decision logic as a foundation and consult field-specific visualization resources.

Do not use this skill to select graphics for decorative purposes. Every graphic must directly support a specific argument or claim.

Context

Required (must be present before proceeding)

  • The data: What values are being presented? How many data points? What variables?
  • The argument: What claim should readers draw from the graphic? What should they notice?

Useful but not required

  • Audience and venue: Specialist readers in your field vs. general audience? Print vs. screen? Black-and-white vs. color?
  • Existing graphic (if revising): Share it as text, a description, or a file so this skill can diagnose specific problems.

Stage 1 — Verbal or Visual?

Before selecting a graphic type, decide whether visualization is necessary at all.

Use prose (no graphic) when:

  • You have 3 or fewer numbers to present. Readers can hold a small set of values in a sentence as easily as in a table.
  • Example: *"In 2013, men earned $50,033 a year and women $39,157, a difference of $10,876."* This sentence communicates the same information as a 3-row table — and takes less space.

Use a graphic when:

  • You have more than a few numbers and prose forces readers to track more values than working memory allows.
  • The relationships or patterns in the data are the point — readers need to see structure, not just remember numbers.
  • The visual comparison is itself the argument (e.g., a dramatic difference in magnitude).

Why this decision matters: Graphics carry an implicit claim of complexity. A table with two rows signals to readers that the data required a table — if it did not, the graphic looks inflated and the writer looks like they are padding the paper with visual bulk.


Stage 2 — Select the Graphic Type

The three primary graphic types each produce a distinct rhetorical effect. Choose the effect that matches your argument.

Table

Rhetorical effect: Precise, objective, neutral. Presents discrete numbers and lets readers draw their own comparisons.

Use when:

  • Exact values matter and readers will need to look up or compare specific numbers
  • You have many variables across multiple categories and readers may need to extract different values depending on their question
  • The argument requires readers to see all the data, not just a highlighted trend

Example trigger: "Here are the unemployment rates for nine countries across two time periods" — readers may want to check any specific country, so exact numbers in a table serve them better than a simplified visual.

Trade-off: A table requires readers to infer relationships themselves (unless you state them in an introductory sentence). A table makes your data available; it does not automatically make your argument visible.


Bar Chart

Rhetorical effect: Visual contrast. Emphasizes differences in magnitude among discrete items.

Use when:

  • The argument is a comparison — one group or item is larger, smaller, or different from others
  • Bars arranged to match your point (e.g., sorted by size, grouped by category) directly support the claim
  • You want readers to see relative sizes at a glance rather than read exact numbers

Example trigger: "Most of the world's deserts are concentrated in North Africa and the Middle East." A bar chart with deserts grouped by region (rather than listed alphabetically) makes that geographic concentration visible as a visual pattern — readers do not have to read and calculate. An alphabetical listing of the same values produces no coherent image.

Trade-off: Bar charts communicate less precisely than tables. Readers see approximate magnitudes, not exact values. Add numbers to bars when exact values also matter.

Variants:

  • *Stacked bars:* Use only when you want readers to compare total bar heights across groups; do not use when the argument depends on comparing individual segment sizes (readers cannot judge segment proportions accurately by eye).
  • *Clustered bars:* Use when segment sizes are as important as totals. Group and order logically; label group totals.
  • *Pie charts:* Avoid for quantitative data — readers cannot accurately judge proportional areas. Acceptable only for qualitative impressions (e.g., "one segment is disproportionately larger than all others combined"). Use bar charts instead for quantitative comparisons.

Line Graph

Rhetorical effect: Continuous change over time. Suggests trend, trajectory, and movement.

Use when:

  • Time is one axis and you want to argue that something changed, increased, or declined
  • The argument is about direction and rate of change, not specific values at points in time
  • Multiple trends need to be compared visually over the same period

Example trigger: "Two-parent households declined steadily from 1970 to 2010 while mother-headed households rose." The line graph conveys this crossing trajectory in a single image; a table of the same values requires readers to read across rows and do arithmetic to see the trend.

Trade-off: A line graph implies continuous change between plotted points. If your data are categorical, intermittent, or collected at uneven intervals, a line graph misleads by implying smooth progression. Use a bar chart for discrete items, even if time is involved.

Variable direction note: Choose the variable that makes the line travel in the direction that supports your argument. If a reduction is good news, you may represent the same data as an increase in the opposing variable (e.g., retention rate instead of dropout rate) to produce a rising line that carries positive visual force.


Stage 3 — Design the Graphic

Once the type is selected, apply these design principles to produce a clear, readable graphic. Resist default software settings — most produce graphics that look complex without communicating clearly.

3.1 Keep It Simple

Include only data relevant to your argument. If you have additional data to report for completeness, label it separately and move it to an appendix.

Why: Readers assume every element of a graphic is there to support your point. Irrelevant data confuses them about what they should conclude.

For tables:

  • Use horizontal lines only (top border, bottom border, header separator). Do not use a grid of horizontal and vertical dark lines — it creates visual noise.
  • For long tables, shade every fifth row lightly to help readers track rows across columns.
  • Do not add background color or shading.

For charts and graphs:

  • Box a graphic only if you are grouping two or more figures together.
  • Do not color or shade the background.
  • Use background grid lines only if the graphic is complex or readers need to read precise values from it. Make grid lines light gray.
  • Use color or shading only to show a contrast. Verify the graphic is still readable in black-and-white (avoid distinguishing elements by color alone if the document may be photocopied).
  • Never use iconic bars (e.g., images of cars to represent automobile production) — they distort how readers judge values and look amateurish.
  • Do not add a third dimension (3D effect) for visual appeal. Three-dimensional bars and pie charts make proportions harder to judge, not easier.

3.2 Use Clear Labels

Label everything: All rows and columns in tables; both axes in charts and graphs; all lines in line graphs.

For graphs and charts:

  • Use tick marks and labels to indicate intervals on the vertical axis.
  • Label lines and bar segments directly on the graphic image when possible. Use a legend only when direct labeling would make the graphic too cluttered to read.
  • When exact values matter, add them to bars (above or inside) or to dots on line graphs.

Why: A graphic that requires readers to scan between image and legend interrupts reading and increases the chance of misidentifying elements. Direct labeling keeps interpretation in the image.

3.3 Order Data to Match Your Argument

Tables: Order rows and columns by the principle that lets readers quickly find the comparison you want them to make. Do not default to alphabetical order unless the argument has no inherent ordering.

Bar charts: Arrange bars to create a visual image that matches your claim. Bars in no particular order imply no particular point.

Example: A bar chart of desert sizes listed alphabetically makes no argument. The same data sorted by region (North Africa, Middle East, Australia, South Africa, North America) immediately supports the claim that deserts cluster in certain geographic zones.

Tables — rounding: Round to the precision that makes differences visible. If differences smaller than 1,000 do not matter to your argument, then 2,123,499 is misleadingly precise — use 2,123,000 or 2.1 million. Place totals at the bottom of columns or the end of rows, not at the top.


Stage 4 — Frame the Graphic in Text

A graphic does not speak for itself. You must frame it with three elements that tell readers what to see and why it matters.

4.1 Provide a Descriptive Title

Tables: Title goes above the table, flush left. Figures (charts, graphs): Legend goes below the figure, flush left.

Rules for titles and legends:

  • Describe the data specifically enough to distinguish this graphic from every other in the document.
  • Do not use a general topic as a title: Not *Heads of households* — Use *Changes in one- and two-parent heads of households, 1970–2010*
  • Do not editorialize in the title — do not characterize what the data imply: Not *Weaker effects of counseling on depressed children before professionalization of staff, 1995–2004* — Use *Effect of counseling on depressed children, 1995–2004*
  • Make the title descriptive, not argumentative. The argument belongs in your introductory sentence (see 4.2).

Why: Titles serve as identifiers when readers scan, search for, or cite a specific figure. An argumentative title permanently embeds your interpretation into the graphic's identity and prevents a reader from drawing an independent conclusion from the data.

4.2 Write an Introductory Sentence

Before every graphic, write one sentence that tells readers what to see in it and how it supports your argument. Do not assume readers will draw the right conclusion.

Structure: State the claim you want the graphic to support, then refer readers to the figure.

Without framing: *Table 15.3. Gasoline consumption.* (Readers must figure out why it is here.)

With framing: *Gasoline consumption has not grown as predicted. Though Americans drove 23 percent more miles in 2000 than in 1970, they used 32 percent less fuel. [See Table 15.3.]*

Why: Readers approach a graphic already looking for whatever the preceding text suggested they would find. Without a framing sentence, readers do not know which relationship in the graphic to focus on — they look everywhere and conclude nothing specific. A good framing sentence makes the reader's eye go directly to the key number, trend, or relationship.

4.3 Add Internal Emphasis When the Data Is Dense

If a graphic contains many values but only a few are directly relevant to your argument, highlight those values internally — for tables, shade the relevant rows or columns; for graphs, annotate key inflection points.

Example: A table showing per-capita mileage and fuel consumption across four decades becomes readable when the percentage-change column is shaded and labeled, directing attention to the relevant comparison. Without shading, readers scan all 16 cells equally.


Stage 5 — Check for Ethical Integrity

A graphic that is technically accurate can still mislead. Before finalizing, run these four checks:

Check 1 — Scale manipulation. Does the vertical axis begin at zero? A truncated scale (starting at a non-zero value) compresses the visible range and exaggerates contrasts. A bar chart where bars appear to show a 50% reduction may actually represent a drop from 94 to 90 on a scale starting at 80. The data are accurate; the visual impression is not.

  • Rule: Do not manipulate scale to magnify or reduce a contrast beyond what the data warrant.

Check 2 — Dual-axis false correlation. Does your line graph use two different vertical scales on left and right axes? Two independent variables measured on different scales will appear to move together if their scales are calibrated to overlap visually. This creates the impression of correlation or causation where neither has been established.

  • Rule: Do not use dual-axis graphs to suggest a relationship between variables unless you have established the relationship through analysis, not visual calibration.

Check 3 — Figure type distorting values. Does the figure's geometry accurately represent the data? Stacked area charts, 3D graphics, and certain pie chart configurations can make the same data appear to show different patterns depending on which elements are placed at the top or bottom.

  • Rule: Do not use a figure whose image distorts the values it displays.

Check 4 — Missing argument statement. If the graphic supports a specific point, have you stated that point? Presenting data without a claim allows readers to draw unintended conclusions.

  • Rule: If the table or figure supports a point, state it. Silence is not neutrality — it is an invitation to misinterpret.

Examples

Example 1: Verbal vs. Visual Decision

Data: Average annual salaries for men ($50,033) and women ($39,157) in 2013, with a difference of $10,876.

Decision: Three numbers. Prose handles this without a graphic — *"In 2013, men earned $50,033 a year on average and women $39,157, a difference of $10,876."* A table here adds visual bulk without adding comprehension.

But: Add four time periods and two additional family types across 40 years (the family structure data), and the same logic flips — 20+ numbers exceeds what readers can hold in working memory from prose. A table or chart is now necessary.


Example 2: Bar Chart vs. Line Graph for the Same Data

Data: Percentages of U.S. families by type (two-parent, mother-headed, father-headed, no-adult-headed) across five decades (1970–2010).

If the argument is: "Family structure changed dramatically over 40 years, with two-parent households declining steadily while mother-headed households tripled."

  • Use a line graph: it visualizes continuous directional change and allows all four trends to be compared over time on a single image.

If the argument is: "In any given year, different family types had dramatically different prevalence rates."

  • Use a bar chart: it emphasizes magnitude contrasts at a given point in time (contrast among discrete items within each year's cluster).

Design note (bar chart): Do not sort bars alphabetically or by family-type name. Group them by year, then order the bars within each group by size — largest first — to make the dominant category immediately visible.


Example 3: Detecting and Correcting an Ethical Violation

Scenario: A bar chart shows a city's pollution index declining from 101 to 90 over twelve years, presented as evidence of significant environmental improvement.

The problem: The vertical axis starts at 80 (not 0). The resulting bars appear to shrink by roughly half their height, creating the visual impression of a ~50% reduction. The actual decline is 101 to 90 — about 11% on the full scale.

Correction: Start the vertical axis at 0. The bars will now show a modest, accurate decline. If the decline is real and meaningful, state it in the introductory sentence: *"Pollution fell 11 percent over twelve years, from 101 to 90."* Do not rely on a distorted visual to inflate the apparent magnitude.


Quick-Reference: Graphic Type Selection

Your argumentData characteristicsBest type
Present all values for reference or lookupMany exact numbersTable
Show difference in magnitude between discrete itemsCategories, no time axisBar chart
Show trend or change over timeContinuous time axisLine graph
Show parts of a whole (totals matter most)Whole + proportional partsStacked bar
Show proportion is disproportionately large/smallOne segment dominatesPie (qualitative only)

See references/graphic-type-rhetorical-effects.md for an extended table of rhetorical uses for additional graphic types (scatter plots, frequency distributions, box plots) used in advanced research contexts.

See references/ethical-visualization-checklist.md for a printable checklist of all five ethical integrity checks.

License

This skill is licensed under CC-BY-SA-4.0. Source: BookForge — The Craft of Research, 4th Edition by Wayne C. Booth, Gregory G. Colomb, Joseph M. Williams, Joseph Bizup, William T. FitzGerald.

Related BookForge Skills

This skill is standalone. Browse more BookForge skills: bookforge-skills

平台分布

OpenClaw

96.84%
按下载量换算628

安全审计

VirusTotal

通过

ClawScan

通过

Static analysis

通过

权限和风险

调用外部服务

该 Skill 可能调用第三方服务、云服务或外部模型 API,使用前需要确认账号、额度、数据发送范围和服务条款。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills