skills/scientific-writing/scientific-schematics/SKILL.md
Designing scientific schematics, diagrams, and graphical abstracts. Covers tool selection (BioRender, Inkscape, Affinity, PowerPoint), design principles for pathway diagrams, mechanism schematics, experimental workflows, and journal graphical abstracts. Includes composition, icon sourcing, color for biological entities, and accessibility. Use when creating illustrative (not data-driven) scientific figures.
npx skillsauth add jaechang-hits/scicraft scientific-schematicsInstall 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.
Scientific schematics are illustrative figures that communicate biological mechanisms, experimental designs, or conceptual frameworks — as distinct from data-driven figures (graphs, heatmaps). A well-designed schematic makes a manuscript's key concept immediately comprehensible to a broad scientific audience, while a poorly designed one confuses reviewers and reduces the paper's impact. This guide covers the design decisions, tool selection, composition principles, and accessibility standards specific to biological schematics in peer-reviewed publications.
Not all schematics serve the same function. Choosing the wrong type leads to overloaded or underspecified figures.
| Type | Purpose | Key Elements | Examples | |------|---------|-------------|---------| | Mechanism diagram | Show step-by-step molecular events | Proteins, DNA, membranes, arrows indicating causality | CRISPR cleavage, signaling cascade, transcription factor binding | | Pathway diagram | Show relationships in a network | Nodes (proteins/metabolites), edges (activation/inhibition), direction | MAPK signaling, metabolic flux, gene regulatory network | | Experimental workflow | Show experimental protocol as a figure | Numbered steps, icons for equipment/samples, time arrows | Single-cell sequencing pipeline, drug treatment protocol | | Graphical abstract | 1-panel summary of entire paper | 2–4 key findings, minimal text, journal-specified dimensions | Cell, Nature, PNAS graphical abstracts | | Structural diagram | Show molecular structure/conformation | Ribbon structure, surface representation, active site | Protein domain schematic, ligand binding pocket |
Decision rule: If the reader needs to understand what happened step-by-step, use a workflow. If they need to understand why (cause and effect), use a mechanism/pathway diagram. If they need a 30-second paper summary, use a graphical abstract.
| Tool | Best For | Learning Curve | Cost | File Output | |------|---------|---------------|------|-------------| | BioRender | Quick biological schematics; built-in icon library | Low | Subscription (~$99/month academic; free for draft) | PNG, SVG, PDF (license required for publication) | | Inkscape | Full vector editing; open-source | Medium–High | Free | SVG, PDF, PNG, EMF | | Affinity Designer | Professional vector + raster hybrid | Medium | ~$55 one-time | SVG, PDF, AFDESIGN | | Adobe Illustrator | Industry standard; full features | High | ~$55/month | SVG, PDF, AI, EPS | | PowerPoint / Keynote | Quick drafts; non-scientists | Low | Included in MS/Apple | PNG (low resolution), PDF | | draw.io / Lucidchart | Flowcharts, pathway diagrams | Low | Free/subscription | SVG, PNG, XML | | ChimeraX / PyMOL | Molecular structure renders | Medium | Free (academic) | PNG, TIFF, movie |
Key difference: BioRender provides curated biological icons (cells, proteins, instruments) that are publication-quality and royalty-free under the publication license. For complex custom graphics, Inkscape (free) or Affinity Designer (paid) offer more flexibility.
Color in biological schematics carries semantic meaning and must be used consistently.
Conventional biological color assignments:
Signal direction conventions:
Accessibility:
Visual hierarchy: The most important element should be the largest and most central. Support elements (labels, arrows, scale bars) should be visually subordinate.
Element spacing: Maintain consistent padding between grouped elements. Crowded diagrams cause readers to misread association between elements.
Arrow semantics: Every arrow must convey exactly one relationship. Do not use arrows interchangeably for "leads to," "causes," "physically binds," and "is required for" — use distinct arrow styles for each.
Text minimalism: Labels should be noun phrases only (not full sentences). Move explanatory text to the figure caption, not into the diagram itself.
What is this schematic trying to communicate?
│
├── A sequence of experimental steps
│ └── → Workflow diagram
│ ├── Numbered panels or numbered arrows
│ ├── Icons for equipment (instrument, pipette, plate, animal)
│ └── Time axis or step axis
│
├── How a molecule works mechanistically
│ └── → Mechanism diagram
│ ├── Protein shapes (surface or cartoon)
│ ├── Conformational change arrows
│ └── Before/after state panels
│
├── How multiple components interact in a network
│ └── → Pathway diagram
│ ├── Nodes = proteins/metabolites (circles, rectangles)
│ ├── Edges = arrows (activation = →, inhibition = ⊣)
│ └── Compartment boxes (nucleus, cytoplasm, extracellular)
│
├── A single-panel paper summary
│ └── → Graphical abstract
│ ├── Check journal specifications (size, text policy)
│ ├── Show: question → approach → key finding → implication
│ └── Minimal text; max 3–4 panels
│
└── A 3D molecular structure
└── → Structural diagram
├── Use ChimeraX, PyMOL, or RCSB PDB viewer for render
├── Annotate active site/binding pocket
└── Add scale bar (Å or nm)
| Scenario | Tool | Format | Key Consideration | |---------|------|--------|-------------------| | First-author manuscript, fast turnaround | BioRender | PDF/SVG | Requires publication license for final submission | | Lab with ongoing schematic needs | Inkscape + master template | SVG | Reusable elements; free; no vendor lock-in | | Graphical abstract for Cell/Nature | BioRender or Illustrator | PNG at journal spec | Check exact pixel dimensions and text policy | | Molecular mechanism with protein structure | ChimeraX + Inkscape | PNG render + SVG annotation | Use PDB structure; annotate key residues | | Pathway diagram with many nodes | draw.io / Cytoscape | SVG/PDF | Auto-layout for networks with >20 nodes |
Start with a sketch before opening any tool: Draw the schematic on paper first. Determine what elements are needed, their hierarchy, and the spatial relationships. Opening software first leads to layout decisions driven by tool constraints, not by communication goals.
Define a consistent visual vocabulary before drawing the first panel: Assign colors, shapes, and arrow styles to each biological entity type at the project level. Document these assignments in a legend or lab style guide. Inconsistency across figures in a paper signals carelessness and confuses reviewers.
Use the journal's graphical abstract template: Every high-impact journal (Cell, Nature, PNAS, PLOS) publishes exact dimensions, resolution requirements, and font rules for graphical abstracts. Download the template before starting — resizing after the fact destroys aspect ratios and makes text too small.
Export at publication resolution from the vector source: Always export final figures from the original vector file (SVG, AI, AFDESIGN) at the target DPI, never by screenshot or screen capture. Screenshots are raster at screen resolution (~72 dpi); journals require 300–600 dpi.
Label arrows and connections in captions, not in the diagram: Arrow labels ("activates," "phosphorylates," "recruits") add clutter and reduce diagram readability. Move these relationships to the figure caption using panel reference labels (A, B, C). The diagram should be self-explanatory to someone who reads the caption.
Group related elements visually using proximity, enclosure, and color: Elements that belong together conceptually should be spatially close, share a background color, or be enclosed in a bounding box. Do not use arbitrary spatial arrangements — viewers interpret proximity as association.
Version-control your source files: Store original editable source files (.svg, .afdesign, .ai, .brd) in version-controlled storage alongside the manuscript. Journals frequently request revised figures during revision, and re-creating from a PNG is extremely time-consuming.
Using inconsistent arrow styles across a figure
Overloading a single panel with too many elements
Using BioRender without purchasing the publication license
Text inside the schematic at 6 pt or smaller at print size
Red–green arrow encoding for activation–inhibition without shape cues
Copying schematic elements from published papers without redrawing
Missing scale bars in structural diagrams
scalebar command or annotate in Inkscape after export..svg/.afdesign/.brd to version control alongside manuscriptgs -sDEVICE=pdfwrite -dUseCIEColor). Verify colors after conversion.open 6YYT → graphics silhouettes true → lighting soft → saveimage figure.png width 2400 height 2400 → annotate in Inkscape.scientific-visualization — data-driven figures (graphs, heatmaps) as distinct from illustrative schematicsscientific-manuscript-writing — figure legend writing and integration of schematics into paperslatex-research-posters — assembling schematics into poster layoutstools
Fast short-read DNA aligner for WGS/WES/ChIP-seq. 2× faster BWA-MEM successor; outputs SAM/BAM with read group headers for GATK. Primary plus supplementary records for chimeric reads. Use STAR for RNA-seq splice-aware alignment; Bowtie2 is a comparable alternative.
tools
smina molecular docking CLI. AutoDock Vina fork with customizable scoring functions, native SDF/MOL2/PDB ligand input, autoboxing, local energy minimization, and per-atom score breakdowns. Pipeline: receptor PDBQT prep -> ligand prep (RDKit/OpenBabel) -> dock via autobox or explicit grid -> rescore/minimize with custom scoring -> rank poses by affinity. Choose smina over Vina when you need custom scoring terms (--custom_scoring), local optimization of an existing pose (--local_only), per-atom contributions (--atom_term_data), or SDF/MOL2 ligands without manual PDBQT conversion. For unknown binding sites use diffdock-blind-docking; for the Python-bindings/Vinardo workflow use autodock-vina-docking.
development
mdtraj molecular dynamics trajectory analysis (Python). Reads DCD/XTC/TRR/NetCDF/H5/PDB topologies and trajectories; computes RMSD vs time, radius of gyration, per-residue RMSF, residue-residue contact frequency maps, phi/psi torsions for Ramachandran plots (general + Gly/Pro), and 8-state DSSP secondary structure. Modules: trajectory I/O, geometry (distances/angles/dihedrals), structural analysis (RMSD/Rg/RMSF/SASA), contacts, hydrogen bonds, secondary structure (DSSP), NMR observables. For broader atom-selection grammar use mdanalysis-trajectory; for running MD simulations use OpenMM/GROMACS.
development
Programmatic PubMed access via NCBI E-utilities REST API. Covers Boolean/MeSH queries, field-tagged search, endpoints (ESearch, EFetch, ESummary, EPost, ELink), history server for batches, citation matching, systematic review strategies. Use for biomedical literature search or automated pipelines.