agentsclimarketplace

Vis writing style

Skill brycewang-stanford/Awesome-Journal-Skills/VIS-Skills/skills/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 encoding and interaction to a task, evaluation matched to the contribution type, honest limitations, and disciplined use of the VGTC/TVCG 9+2 page budget for a paper that will be read as an IEEE TVCG journal article.From its SKILL.md

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill vis-writing-style

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

5.3 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

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

SectionJob it must doCommon failure
IntroData/task problem, inadequacy, contribution, evidence preview, payoff — first pageLeads with a technology trend or a screenshot, not a task
Related workPosition against the nearest visualization prior work as a deltaCatalog of citations with no contrast
Data & task abstractionWhat data, what tasks, at what abstraction levelJumps to a design with no task grounding
Design / techniqueThe encoding + interaction, each justified by taskDesign by aesthetics; unjustified channels
EvaluationEvidence matched to the contribution typeMethod mismatched to the claim (e.g., accuracy for a usability claim)
Limitations & discussionWhere it breaks; what generalizesGeneric paragraph untethered to this design

Sentence-level rewrites

Draft patternVIS-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)>

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.