scientific-schematics

Automates publication-quality scientific diagrams (e.g., flowcharts, architectures, pathways) when you need journal/poster-ready visuals from a natural-language description.

53 stars

Best use case

scientific-schematics is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Automates publication-quality scientific diagrams (e.g., flowcharts, architectures, pathways) when you need journal/poster-ready visuals from a natural-language description.

Teams using scientific-schematics should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/scientific-schematics/SKILL.md --create-dirs "https://raw.githubusercontent.com/aipoch/medical-research-skills/main/scientific-skills/Other/scientific-schematics/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/scientific-schematics/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How scientific-schematics Compares

Feature / Agentscientific-schematicsStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Automates publication-quality scientific diagrams (e.g., flowcharts, architectures, pathways) when you need journal/poster-ready visuals from a natural-language description.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)

# Scientific Schematics Skill

## When to Use
- Creating **journal-ready** figures (clean typography, consistent styling, high resolution) from a short textual description.
- Producing **poster-friendly** diagrams that prioritize readability at distance (larger labels, stronger contrast).
- Drafting **neural network architecture** schematics (e.g., Transformer blocks, attention modules) for papers or slides.
- Generating **biological pathway** visuals (e.g., Krebs cycle) with iterative quality review.
- Rapidly iterating on a diagram concept when you need **AI-assisted refinement loops** instead of manual redraws.

## Key Features
- **Text-to-diagram automation**: Converts a natural-language prompt into a publication-quality schematic.
- **Iterative generate → review → refine loop**: Automatically improves the figure until a quality threshold is met.
- **Document-type aware critique**: Reviewer feedback adapts to `journal` vs `poster` requirements.
- **Model-configurable pipeline**: Choose separate LLMs for generation and vision-based review.
- **Output validation**: Performs final checks (e.g., resolution/accessibility considerations) before saving to `figures/`.
- Reference guidance:
  - Best practices: `references/best_practices.md`
  - Supported diagram categories: `references/diagram_types.md`

## Dependencies
- Python 3.10+ (recommended)
- Python packages:
  - `pillow` (PIL)
  - `matplotlib`
  - `requests`
- Environment:
  - `OPENROUTER_API_KEY` (required)

## Example Usage
### 1) Set the OpenRouter API key
**Windows (PowerShell)**
```powershell
$env:OPENROUTER_API_KEY="your_key_here"
```

**Linux/macOS**
```bash
export OPENROUTER_API_KEY="your_key_here"
```

### 2) Run the generator (journal/poster)
```bash
python scripts/generate_schematic.py "Transformer architecture with attention mechanism" --doc-type journal
```

### 3) Override the generation model
```bash
python scripts/generate_schematic.py "Krebs cycle" --doc-type journal --generator anthropic/claude-3.5-sonnet
```

### 4) (Optional) Override both generator and reviewer
```bash
python scripts/generate_schematic.py "Flowchart of a clinical trial enrollment pipeline" \
  --doc-type poster \
  --generator google/gemini-2.0-flash-001 \
  --reviewer google/gemini-2.0-flash-001
```

## Implementation Details
### Pipeline Stages
1. **Generation**
   - A code-capable LLM converts the prompt into a diagram image.
   - Default generator model: `google/gemini-2.0-flash-001`.

2. **Review**
   - A vision-capable LLM evaluates the generated image against the target `--doc-type`.
   - Default reviewer model: `google/gemini-2.0-flash-001`.
   - The reviewer returns actionable critique and a numeric quality score.

3. **Refinement Loop**
   - If the score is below the acceptance threshold (e.g., **8.5/10**), the system re-enters generation using the reviewer’s feedback as constraints.
   - This repeats until the threshold is met or the run terminates by internal stopping conditions.

4. **Finalization**
   - Performs final checks such as **resolution suitability** and **accessibility-oriented considerations** (e.g., legibility).
   - Saves the final artifact to the `figures/` directory.

### Key Parameters
- `--doc-type <journal|poster>`: Controls review criteria (e.g., density/precision for journals vs readability/scale for posters).
- `--generator <model_id>`: Model used to produce the diagram.
- `--reviewer <model_id>`: Model used to critique the diagram.
- **Quality threshold**: A numeric cutoff (example: `8.5/10`) that determines whether refinement continues.

Related Skills

scientific-podcast-summary

53
from aipoch/medical-research-skills

Automatically summarize scientific podcasts like Huberman Lab and Nature.

skill-auditor

53
from aipoch/medical-research-skills

A comprehensive auditor for any agent skill — including Manus, OpenClaw/ClawHub, Claude, LobeHub, or custom SKILL.md-based skills. Use this skill whenever a user wants to evaluate, audit, review, score, or quality-check an agent skill before publishing, updating, or deploying. Covers two hard veto gates (structural redlines + research integrity redlines), static quality scoring across 25 criteria (ISO 25010 + OpenSSF + Agent), dynamic test input generation, multi-mode execution testing, multi-layer output evaluation with five specialized category rubrics (Evidence Insight / Protocol Design / Data Analysis / Academic Writing / Other), a Research Veto that applies to all four research categories, human eval viewer generation, actionable P0/P1/P2 optimization recommendations, and automatic skill improvement that outputs a polished, production-ready SKILL.md. Also use whenever a user says "audit my skill", "evaluate my skill", "improve my skill", or wants a corrected version after evaluation.

two-sample-mr-research-planner

53
from aipoch/medical-research-skills

Generates complete two-sample Mendelian randomization (MR) research designs from a user-provided research direction. Use when users want to design, plan, or build a study using two-sample MR to test causal relationships. Triggers:"design a two-sample MR study", "build a publishable MR paper", "test whether this biomarker causally affects this disease", "generate Lite/Standard/Advanced MR plans", "screen multiple exposures with MR", "bidirectional MR design", "causal inference using GWAS summary statistics", or "I want to study X and Y using MR". Always outputs four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.

research-proposal-generator

53
from aipoch/medical-research-skills

Generates a comprehensive research proposal design based on input literature, including hypothesis, mechanism verification, and budget. Use when the user wants to design a research project from a paper.

research-grants

53
from aipoch/medical-research-skills

Write competitive research proposals for NSF, NIH, DOE, DARPA, and Taiwan's NSTC when you need agency-compliant narratives, budgets, and review-criteria alignment for a specific solicitation/FOA/BAA.

protocol-standardization

53
from aipoch/medical-research-skills

Standardize fragmented experimental steps into reproducible protocol documents when you need method organization, lab SOP drafting, or cross-operator reproducibility; missing parameters must be explicitly marked as "To be supplemented/Not provided".

prospero-registration-helper

53
from aipoch/medical-research-skills

Assists researchers in generating PROSPERO registration content for meta-analyses from a title and optional protocol. Use when the user wants to draft a PROSPERO registration form.

non-tumor-ml-research-planner

53
from aipoch/medical-research-skills

Generates complete non-tumor biomedical machine learning research designs from a user-provided research direction. Always use this skill when users want to plan bioinformatics + ML papers for non-cancer diseases (metabolic, cardiovascular, kidney, inflammatory, autoimmune, infectious, neurological, endocrine, wound healing, chronic multifactor), design diagnostic biomarker studies, combine GEO datasets with feature selection and ML modeling, or generate Lite/Standard/Advanced/Publication+ workload plans. Trigger for:"non-tumor ML study", "bioinformatics paper outside oncology", "key genes and diagnostic model for a disease", "pyroptosis/ferroptosis/senescence/autophagy + disease", "GEO datasets + machine learning", "RF + LASSO diagnostic model", "DEG + feature selection + validation", "immune infiltration + biomarker", "non-cancer biomarker paper". Trigger even for casual phrasings like "I want to study X using machine learning", "help me design a non-tumor bioinformatics paper", or "how do I build a diagnostic model for disease Y".

network-tox-docking-research-planner

53
from aipoch/medical-research-skills

Generates complete network toxicology + molecular docking research designs from a user-provided toxicant and disease/phenotype. Always use this skill when users want to investigate how an environmental toxicant, endocrine disruptor, heavy metal, food contaminant, pharmaceutical residue, or consumer product chemical may contribute to a disease through shared molecular targets, hub genes, pathways, and docking evidence. Trigger for:"network toxicology study", "toxicology mechanism paper", "target prediction + PPI + docking", "environmental pollutant and disease mechanism", "hub genes and docking for toxicant", "Lite/Standard/Advanced toxicology plan", "CTD + SwissTargetPrediction + GeneCards + STRING", "CB-Dock2 docking study", "triclosan/BPA/cadmium/PFAS + disease". Also triggers for Chinese phrasings:"网络毒理学研究设计"、"毒物机制论文"、"靶点预测+PPI+对接"、"环境污染物与疾病机制". Trigger even for casual phrasings like "I want to study how chemical X affects disease Y" or "help me design a toxicology paper". Always output four workload configurations (Lite / Standard / Advanced / Publication+) with a recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, and publication upgrade path.

meta-protocol-writer

53
from aipoch/medical-research-skills

Generates a PROSPERO-compliant Meta-analysis protocol based on Title and PICOS. Use when the user wants to write a protocol for a systematic review or meta-analysis.

hypothesis-generation

53
from aipoch/medical-research-skills

Structured scientific hypothesis formulation from observations; use when you have experimental observations or preliminary data and need testable hypotheses with predictions, mechanisms, and validation experiments.

hypogenic

53
from aipoch/medical-research-skills

Automated LLM-driven hypothesis generation and testing for tabular datasets; use when you need systematic exploration of empirical patterns (e.g., fraud detection, content analysis) and want to combine literature insights with data-driven hypothesis evaluation.