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-schematicsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scientific-schematics (this skill)by jaechang-hits | 87 | 367 | 37d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 90.8k | 19d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 85.7k | today | MCP Server |
| rufloby ruvnet | 100 | 73.9k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 12d ago | SKILL.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.
Skill content
View source on GitHubname: "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
-
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.
Common Pitfalls
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
Missing scale bars in structural diagrams
- What goes wrong: Protein structure renderi
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
90.8kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Scrapling
85.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
ruflo
73.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
