SkillAgentSearch skills...

scientific-visualization

Guide for choosing and creating scientific visualizations for publications and talks. Covers chart-type selection by data structure, color theory for accessibility/print, figure composition, journal formatting (Nature, Cell, ACS), and common pitfalls.

Install / Use

npx skills add jaechang-hits/SciAgent-Skills --skill scientific-visualization

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Supported Platforms

Universal

Tags

Our assessment of scientific-visualization

scientific-visualization scores 87/100 on our quality scale, 2050th of 4,619 Development & Engineering skills we index (top 45%).

Its SKILL.md is 14 KB long, well organised into 14 sections with 1 code example: a thorough specification that gives an agent plenty to work with.

It has 367 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
17/20
Description
15/15
Adoption
11/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 37 days ago, so scientific-visualization is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

scientific-visualization compared with similar skills

All 4 of these similar skills score higher than scientific-visualization; compare them before choosing.

SkillScoreStarsUpdatedFormat
scientific-visualization (this skill)by jaechang-hits8736737d agoSKILL.md
ai-job-searchby MadsLorentzen10045.0k1d agoCLAUDE.md
claude-howtoby luongnv8910041.7k4d agoCLAUDE.md
algorithmic-artby anthropics100177.9k12d agoSKILL.md
pptxby anthropics100177.9k12d agoSKILL.md

Frequently asked questions

How do I install scientific-visualization?
Run npx skills add jaechang-hits/SciAgent-Skills --skill scientific-visualization. The install tabs above show the steps for each supported agent.
Which AI agents does scientific-visualization work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is scientific-visualization safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is scientific-visualization still maintained?
The repository was last updated 37 days ago, so scientific-visualization is actively maintained.

name: "scientific-visualization" description: "Guide for choosing and creating scientific visualizations for publications and talks. Covers chart-type selection by data structure, color theory for accessibility/print, figure composition, journal formatting (Nature, Cell, ACS), and common pitfalls. Consult when visualizing data or preparing submission figures." license: "CC-BY-4.0"

scientific-visualization

Overview

Effective scientific visualization communicates data clearly, honestly, and accessibly. Poor chart choices, misleading axes, or inaccessible color palettes can obscure findings or introduce bias. This guide covers the full workflow of scientific figure preparation: from selecting the right chart type for your data structure through color theory, accessibility, and journal submission formatting requirements.

Key Concepts

Chart Type and Data Type Alignment

Every chart type is optimized for a specific data structure. Mismatches (e.g., pie charts for continuous distributions, bar charts for time series) hide structure and distort perception.

| Data Type | Recommended Chart | Avoid | |-----------|------------------|-------| | Continuous distribution (1 group) | Histogram, violin plot, ridge plot | Bar chart with mean only | | Continuous distribution (2–5 groups) | Violin + boxplot overlay, beeswarm | Grouped bar chart | | Two continuous variables, correlation | Scatter plot, hexbin (large N) | Line chart without temporal order | | Categorical counts / proportions | Bar chart (horizontal for long labels) | Pie chart (>4 categories) | | Change over time (continuous) | Line chart | Bar chart | | Change over time (sparse events) | Step chart, event raster | Connected scatter | | Part-to-whole (≤5 parts) | Stacked bar, waffle chart | 3D pie chart | | High-dimensional (>5 variables) | Heatmap (clustered), parallel coordinates | 3D scatter | | Spatial data | Map, spatial heatmap | Bubble chart | | Survival / time-to-event | Kaplan-Meier curve | Bar chart of median survival |

Color Theory for Science

Color encodes information. Misused color introduces artifacts and fails readers with color vision deficiency (CVD; ~8% of males).

Sequential palettes encode ordered numeric data from low to high (e.g., expression level, concentration). Use perceptually uniform palettes: viridis, magma, cividis. These also print in grayscale.

Diverging palettes encode data with a meaningful midpoint (e.g., fold-change centered at 0, correlation from -1 to +1). Use RdBu, coolwarm, or vlag. Always ensure the midpoint maps to white/neutral.

Qualitative palettes encode unordered categories. Use Okabe-Ito (CVD-safe), tab10 (matplotlib default), or ColorBrewer qualitative palettes. Limit to ≤8 distinguishable colors; use shape or pattern as redundant encoding beyond that.

Color don'ts:

  • Rainbow/jet colormap: not perceptually uniform; creates false contours
  • Red vs. green encoding: fails deuteranopia (~6% males)
  • Saturated color for background or large areas

Figure Composition and Layout

Scientific figures are typically multi-panel. Panel layout and labeling affect how readers parse information.

  • Panel labels: Bold uppercase letters (A, B, C) in the top-left corner; use 8–12 pt in the figure, larger in the caption reference.
  • Alignment: Align panel edges on a grid. Unaligned panels signal lack of attention to detail.
  • White space: Leave adequate margins; crowded panels reduce readability.
  • Figure size: Design for the target column width — single column (~85 mm / 3.35 in), 1.5 column (~114 mm / 4.5 in), or double column (~170 mm / 6.7 in) for Nature-family journals.
  • Font: Sans-serif (Arial, Helvetica) at 6–8 pt minimum in the final figure at publication resolution.

Journal Formatting Requirements

Major journals specify exact figure requirements for submission. Violating these causes desk-rejection delays.

| Journal/Style | Max Width | Resolution | Color Mode | Font | File Format | |---------------|-----------|------------|------------|------|-------------| | Nature family | 89 mm (1-col), 183 mm (2-col) | 300 dpi (photos), 600 dpi (line art) | RGB or CMYK | Arial 5–7 pt | PDF, TIFF, EPS | | Cell/iScience | 85 mm (1-col), 170 mm (2-col) | 300 dpi raster, 600 dpi halftone | RGB | Helvetica 6–8 pt | PDF, EPS, TIFF | | ACS journals | 3.25 in (1-col), 7 in (2-col) | 600 dpi (color), 1200 dpi (b&w line art) | RGB (screen), CMYK (print) | Arial/Helvetica 4.5–7 pt | TIFF, EPS, PDF | | PLOS ONE | No strict width | 300 dpi (raster), 600–1200 dpi (line art) | RGB | Any | TIFF, EPS, PDF |

Decision Framework

Use this tree to select the right visualization for your analysis goal:

What is the primary message of this figure?
|
+-- Show a distribution or spread of values
|   +-- One group         --> Histogram or violin plot
|   +-- 2-5 groups        --> Violin + jitter (show all points if N < 100)
|   +-- Many groups       --> Ridge plot (joy plot)
|
+-- Compare quantities between categories
|   +-- Few categories (2-5)    --> Bar chart with error bars + individual points
|   +-- Many categories (>8)    --> Lollipop chart or dot plot (horizontal)
|   +-- Paired measurements     --> Slopegraph or paired dot plot
|
+-- Show a relationship between two continuous variables
|   +-- N < 1000                --> Scatter plot
|   +-- N > 1000                --> Hexbin or 2D density plot
|   +-- Time ordered            --> Line chart
|
+-- Show composition or part-to-whole
|   +-- 2-4 parts               --> Stacked bar or waffle chart
|   +-- Over time               --> Stacked area chart
|   +-- Avoid pie chart unless <= 3 parts and proportions are obvious
|
+-- Show high-dimensional data
|   +-- Genes x samples         --> Clustered heatmap (seaborn.clustermap)
|   +-- Embeddings (UMAP, PCA)  --> Scatter colored by metadata
|   +-- Feature importance      --> Horizontal bar chart (sorted)
|
+-- Show spatial or geographic data
|   +-- Microscopy              --> Image overlay with colorbar
|   +-- Geographic              --> Choropleth map

| Analysis Goal | Chart Type | Library | Key Consideration | |---------------|-----------|---------|-------------------| | Gene expression across groups | Violin + jitter | seaborn, plotnine | Show all points if N < 50; never bar+SEM only | | Differential expression | Volcano plot | matplotlib | Log2FC on x-axis, -log10(p) on y-axis | | Clustering results | UMAP scatter | scanpy, matplotlib | One plot per annotation variable | | Correlation matrix | Clustered heatmap | seaborn.clustermap | Use diverging palette centered at 0 | | Protein structure | Ribbon diagram | PyMOL, ChimeraX | Not covered here — use dedicated molecular graphics tools | | Survival analysis | Kaplan-Meier | lifelines | Include confidence bands and at-risk table | | Time course | Line chart with CI | matplotlib | Show uncertainty; connect group means, not individual points |

Best Practices

  1. Show the data, not just summaries: For N < 100, overlay individual data points on violin or box plots using jitter or beeswarm. Bar charts with only mean ± SEM conceal distribution shape, outliers, and bimodality.

  2. Choose CVD-safe color palettes by default: Use Okabe-Ito or viridis/cividis for sequential data. Test your figure with a CVD simulator (e.g., Coblis) before submission.

  3. Design at final publication size from the start: Set your figure canvas to the exact column width of the target journal (e.g., 89 mm for Nature single-column). Rescaling after the fact makes fonts too small or too large, and changes aspect ratios.

  4. Label axes with units and use descriptive titles: Every axis must have a label with units in parentheses (e.g., "Expression level (log2 CPM)"). Avoid cryptic abbreviations without legend entries.

  5. Use vector formats for line art and text: Save figures as PDF or SVG when they contain text and lines. Rasterize only when submitting to a journal that requires TIFF. Vector figures scale without pixelation and remain editable.

  6. Match statistical annotations to the test performed: If you annotate significance stars (*), state in the caption which test was used, the exact p-value, and the sample size. "n.s." should still report the p-value.

  7. Avoid dual y-axes: Two different y-axes on one plot are almost always misleading — the apparent relationship depends on scale choices. Use two separate panels instead.

Common Pitfalls

  1. Bar chart for continuous distributions (dynamite plot)

    • What goes wrong: Mean ± SEM bars hide whether data is normally distributed, multimodal, or has outliers. Two datasets with identical bars can have completely different distributions.
    • How to avoid: Use violin plots, box-and-whisker with jitter, or beeswarm plots. Show all data points when N < 50.
  2. Truncated or broken y-axis that exaggerates differences

    • What goes wrong: Starting the y-axis at a non-zero value makes small differences appear large and misleads readers about effect size.
    • How to avoid: Start y-axis at zero for ratio/count data. If zooming in is genuinely needed, use an inset or a separate panel with a clear label indicating the truncation.
  3. Using rainbow/jet colormap for heatmaps

    • What goes wrong: Jet is not perceptually uniform — it creates false contour lines and fails under CVD and grayscale printing.
    • How to avoid: Use viridis, magma, or inferno for sequential; RdBu or coolwarm for diverging data. These are the defaults in seaborn >= 0.12.
  4. Overlapping data points without jitter or transparency

    • What goes wrong: Points stack on top of each other (overplotting), making dense regions appear sparse and hiding the true data density.
    • How to avoid: Add jitter (seaborn.stripplot(jitter=True)), use transparency (alpha=0.3), or switch to a hexbin / 2D density plot for large N.
  5. P-value annotations without effect size or sample size

    • What goes wrong: A statistically significant result (p < 0.05) with N = 10,000 may be scientifically trivial. Stars alone are uninformative.
    • How to avoid: Report exact p-values, effect sizes (Cohen's d, odds ratio), and sample sizes in the figure caption or directly on the plot.
  6. Figure text too small at publication size

    • What goes wrong: Designing at screen size and then shrinking to journal column width results in 3–4 pt text that fails minimum readability standards.
    • How to avoid: Design at final print size from the start. Check that axis labels are ≥ 6 pt at the final dimensions.
  7. Inconsistent style across panels in a multi-panel figure

    • What goes wrong: Different fonts, line widths, or color schemes across panels make the figure look unprofessional and harder to compare.
    • How to avoid: Define a shared matplotlib.rcParams style dictionary at the top of your figure script and apply it to all panels.

Workflow

  1. Define the message first

    • Write one sentence describing what you want the reader to take away from this figure.
    • Choose the chart type that most directly communicates that message using the Decision Framework above.
  2. Prepare the data

    • Aggregate, tidy, and validate your data before plotting.
    • Check for outliers that should be investigated, not silently dropped.
  3. Prototype at screen resolution

    • Build a draft figure in your preferred library (matplotlib, seaborn, ggplot2, plotnine).
    • Focus on getting data and chart type right; ignore styling at this stage.
  4. Apply journal-specific styling

    • Set canvas size to target journal column width.
    • Set font family and minimum size.
    • Choose CVD-safe palette.
    • Standardize line widths (0.5–1.0 pt for axes and ticks, 1.0–2.0 pt for data lines).
  5. Add annotations and labels

    • Pa

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars367
CategoryDevelopment
Updated1mo ago
Forks36

Languages

Python

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium