vis-writing-style
Use when revising an IEEE VIS paper for a task-grounded visualization contribution on the first page, a design rationale that ties each visual encod…
它会碰到什么
这一栏是扫描器报的事实,不是结论。命中多不等于有毒(安全工具、规则库、示例脚本本来就会包含危险写法),命中少也不等于干净。它和你手上的凭据、文件、网络有什么关系,需要你自己看。
技能内容
VIS Writing Style
Use this when revising the main paper. IEEE VIS papers are IEEE TVCG journal articles read by
visualization researchers, so they need a **task-grounded visualization contribution stated on the
first page and a design rationale a reviewer trusts**. The failure this skill prevents is a
technically fine paper that reads like a gallery of pretty pictures, or an ML/systems result with a
chart bolted on, instead of a contribution about how people see and reason with data.
Revision rules
- Lead with the visualization contribution: the data-and-task problem, why existing
representations are inadequate for it, the contribution (technique, system, study, or model), the
evidence, and what changes for people analyzing data.
- Justify every encoding and interaction by task. Each visual channel (position, length, color,
shape) and each interaction (filter, brush, link) should be tied to the analysis task it serves —
not chosen by habit. An unjustified encoding is the fastest VIS reject.
- Match evaluation to the contribution type. A perceptual claim needs a controlled study; a
technique needs a benchmark or comparison; a design study needs reflection and validation across
abstraction levels; a system needs a demonstration of real use. Do not evaluate a system with an
accuracy number that answers a different question.
- Report limitations honestly. Name where the encoding breaks down (scale, occlusion, data
type), where the study's validity is bounded, and what you did not test — reviewers reward candor
and punish over-claiming.
- Respect the 9+2 page budget as a design constraint, not a formatting afterthought; a
figure-heavy field forces deliberate space choices.
- Maintain double-blind wording (if you opted in) in self-citations, system names,
acknowledgements, and open-materials links.
Visualization-paper skeleton
| Section | Job it must do | Common failure |
|---|---|---|
| Intro | Data/task problem, inadequacy, contribution, evidence preview, payoff — first page | Leads with a technology trend or a screenshot, not a task |
| Related work | Position against the nearest visualization prior work as a delta | Catalog of citations with no contrast |
| Data & task abstraction | What data, what tasks, at what abstraction level | Jumps to a design with no task grounding |
| Design / technique | The encoding + interaction, each justified by task | Design by aesthetics; unjustified channels |
| Evaluation | Evidence matched to the contribution type | Method mismatched to the claim (e.g., accuracy for a usability claim) |
| Limitations & discussion | Where it breaks; what generalizes | Generic paragraph untethered to this design |
Sentence-level rewrites
| Draft pattern | VIS-safe rewrite |
|---|---|
| "Our tool is intuitive and powerful." | "supports task T; in the study, users completed T faster (effect size ..., 95% CI ...) than with <baseline>" |
| "We use color to show the values." | "we encode magnitude with a CVD-safe luminance ramp because the task is ordered comparison" |
| "The visualization looks clean." | Claim scoped to a task outcome or a measured perceptual property, not aesthetics |
| "We evaluate on a large dataset." | "we demonstrate on <dataset>, chosen because it exhibits <property> the technique targets" |
| "Users liked the system." | "in the study, N of P participants preferred it for task T; qualitative themes in §7" |
Design-rationale discipline
[Data] what is the data type (quantitative/ordinal/nominal/temporal/network/spatial)?
[Task] what analysis task (compare/locate/cluster/correlate/track-change)?
[Encoding] which channel serves that task, and why is it more effective than the obvious default?
[Interaction] which interaction reduces the cost of the task, and what does it cost the user?
-> state each choice next to the view it produces, not as a separate "we chose colors" aside
Vignette: rescuing a design-by-screenshots draft
A draft that opens with a system screenshot and lists features: rewrite the intro to lead with the
domain data and the analyst's task; add a data/task abstraction section; for each view, add one
sentence tying its encoding to a task; replace "users found it useful" with the study's measured
outcomes and qualitative themes; and add a limitations paragraph naming the scale at which the main
view degrades. The test of a good revision: a reviewer can answer "what task does each view serve,
and what is the evidence it serves it?" from the body alone.
Output format
[Writing diagnosis] clear / under-motivated / design-by-aesthetics / evaluation-mismatched / over-claimed
[First-page fix] <new framing leading with the data/task contribution>
[Encoding audit] <view -> channel -> task served -> justified? yes/no>
[Evaluation match] <contribution type -> evidence type -> present? yes/no>
[Anonymity edits] <system names / self-citations / links to rewrite (if double-blind)>想直接用这个技能?
本站把开放许可(MIT / Apache 等)的技能按仓库打包整理到网盘,点一下转存到你自己的网盘,不用一个个从 GitHub 拉。许可未声明的技能只给原始仓库链接,不打包。
它属于哪个仓库
VIS-Skills/skills/vis-writing-style/SKILL.md