SkillAgentSearch skills...

scientific-schematics

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.

Install / Use

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

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Category

Automation

Supported Platforms

Universal

Our assessment of scientific-schematics

scientific-schematics scores 87/100 on our quality scale, 1632nd of 2,866 Automation skills we index.

Its SKILL.md is 15 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-schematics 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-schematics compared with similar skills

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

SkillScoreStarsUpdatedFormat
scientific-schematics (this skill)by jaechang-hits8736737d agoSKILL.md
Agent-Reachby Panniantong10090.8k19d agoCLAUDE.md
Scraplingby D4Vinci10085.7ktodayMCP Server
rufloby ruvnet10073.9ktodayMCP Server
algorithmic-artby anthropics100177.9k12d agoSKILL.md

Frequently asked questions

How do I install scientific-schematics?
Run npx skills add jaechang-hits/SciAgent-Skills --skill scientific-schematics. The install tabs above show the steps for each supported agent.
Which AI agents does scientific-schematics 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-schematics 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-schematics still maintained?
The repository was last updated 37 days ago, so scientific-schematics is actively maintained.

name: "scientific-schematics" description: "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." license: "CC-BY-4.0"

Scientific Schematics

Overview

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.

Key Concepts

1. Schematic Types and Their Purpose

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.

2. Tool Comparison

| 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.

3. Color Usage in Biological Schematics

Color in biological schematics carries semantic meaning and must be used consistently.

Conventional biological color assignments:

  • DNA: double helix colored in blue/navy or gray
  • mRNA: orange or yellow
  • Protein: varying; use consistent color per protein family across all figures in a paper
  • Cell nucleus: light gray or blue fill
  • Cell membrane: tan/beige bilayer
  • Mitochondria: orange
  • Lysosomes: red/purple

Signal direction conventions:

  • Arrows: activation (→ solid arrowhead), inhibition (⊣ flat bar), indirect (- - →)
  • Color coding arrows: green = activating, red = inhibiting, gray = neutral/context

Accessibility:

  • Never use red–green encoding alone; add shape cues (✓/✗, solid/dashed)
  • Test with CVD simulator before submission
  • Use at least 3:1 contrast ratio for text on colored backgrounds

4. Composition and Layout Principles

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.

Decision Framework

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 |

Best Practices

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

Common Pitfalls

  1. Using inconsistent arrow styles across a figure

    • What goes wrong: Solid arrows and dashed arrows mixed arbitrarily make readers unsure whether dashed means "indirect," "hypothetical," or merely a stylistic choice.
    • How to avoid: Define an arrow legend: solid arrow = direct activation, dashed = indirect, flat bar = inhibition. Use this consistently in every panel of every figure in the paper.
  2. Overloading a single panel with too many elements

    • What goes wrong: Pathway diagrams with 20+ nodes and 30+ arrows cannot be read in a journal figure at 170 mm width. Reviewers ask for simplification; revisions are time-consuming.
    • How to avoid: Limit mechanism panels to ≤8 elements. Move complex pathway context to supplementary figures. Focus the main-text schematic on the core novel finding.
  3. Using BioRender without purchasing the publication license

    • What goes wrong: BioRender figures created under the free or draft license cannot be published. Submitting without proper licensing violates BioRender's terms of service and risks manuscript rejection.
    • How to avoid: Purchase the publication license before creating the final figure version. BioRender generates a citation string that must be included in the figure legend.
  4. Text inside the schematic at 6 pt or smaller at print size

    • What goes wrong: Labels inside pathway nodes or protein icons become illegible at publication dimensions (85 mm single-column). Reviewers flag this; revision requires recreating the entire figure.
    • How to avoid: Work at print size from the start. In Inkscape: set canvas to 85 mm × target height. Minimum label size: 7 pt at 100% print scale.
  5. Red–green arrow encoding for activation–inhibition without shape cues

    • What goes wrong: ~8% of male readers have red–green color vision deficiency and cannot distinguish activation (green) from inhibition (red) arrows.
    • How to avoid: Use distinct arrow shapes: → for activation, ⊣ for inhibition. Color is redundant encoding, not the only cue.
  6. Copying schematic elements from published papers without redrawing

    • What goes wrong: Reproducing figures from published papers without permission violates copyright. This applies to diagrams and icons, not just photographs.
    • How to avoid: Use BioRender's licensed icon library, Reactome's freely licensed pathway diagrams (CC-BY), or Bioicons (free, open icons). Always redraw; never screenshot.
  7. Missing scale bars in structural diagrams

    • What goes wrong: Protein structure renderi

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars367
CategoryAutomation
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