scientific-schematics

Generate publication-quality scientific diagrams as PNG images via OpenRouter with iterative quality review.

1|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/CliffVale/opencode-free-setup --skill scientific-schematics-cliffvale
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scientific-schematics
Source: https://github.com/CliffVale/opencode-free-setup/tree/main/skills/scientific-schematics
Command: npx skills add https://github.com/CliffVale/opencode-free-setup --skill scientific-schematics-cliffvale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Creating publication-quality scientific figures (flowcharts, neural network architectures, biological pathways, circuit diagrams) normally requires manual drawing tools and design expertise. This Skill generates them from natural-language descriptions and automatically reviews each image against a quality threshold for your document type. ## Core Features & Use Cases - Natural-language diagram generation: Describe a CONSORT flowchart, Transformer architecture, MAPK pathway, or system block diagram and receive a PNG via the Nano Banana 2 image model on OpenRouter. - Smart iterative refinement: Gemini 3.6 Flash scores each image against document-type thresholds (journal 8.5/10 down to presentation 6.5/10) and regenerates only when below threshold, capped at 2 iterations. - Auditable review logs: Every run writes versioned images plus a JSON review log with scores, critiques, and early-stop reasons; failed reviews are recorded as unmeasured rather than given a fabricated score. - Use Case: A researcher needs a CONSORT participant flow diagram for a journal submission. They describe the screening, exclusion, and randomization counts, run the script with --doc-type journal, and get a reviewed PNG plus an auditable score log. ## Quick Start Ask the agent to generate a scientific diagram, for example: create a CONSORT participant flow diagram with 500 screened, 150 excluded, and 350 randomized, saved to figures/consort.png for a journal paper.

Frequently Asked Questions about scientific-schematics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a scientific diagram from a text description?▼

Run scripts/generate_schematic.py with a natural-language prompt and an output path, for example a CONSORT flowchart or neural network description. The script calls the Nano Banana 2 image model through OpenRouter and saves a PNG to the path you specify.

How does the iterative quality review work for generated figures?▼

Each generated image is reviewed by Gemini 3.6 Flash, which scores it 0-10 against a threshold for your document type (journal 8.5, presentation 6.5). If the score is below threshold, the prompt is improved with the critique and the image regenerates, up to a maximum of 2 iterations.

What API key do I need for AI diagram generation?▼

You need an OpenRouter API key, available at openrouter.ai/keys. Set it as the OPENROUTER_API_KEY environment variable, place it in a .env file, or pass it with the --api-key flag. Prompts and images are sent to OpenRouter, so avoid unpublished or sensitive data.

Can this produce vector or 300 DPI figures for journal submission?▼

No. The output is a raster PNG at whatever resolution the image model returns; there is no vector path, DPI control, or CMYK output. If a journal requires PDF, EPS, or 300 dpi TIFF, convert the PNG downstream and verify it at final print size.

Why does my review log show score null and reviewed false?▼

That means the review call failed, for example due to a rate limit or an unparseable response, so no score was measured. The image is still generated and kept; inspect it yourself and re-run, since these failures are usually transient.