Agent skill

Engineering Figure Agent

by heyu-233 in heyu-233/engineering-figure-agent

A skill your agent uses when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure…

MITAuto-check passedResearch & Science

Install Engineering Figure Agent

skills CLI
$ npx skills add heyu-233/engineering-figure-agent --skill engineering-figure-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install heyu-233/engineering-figure-agent engineering-figure-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
engineering-figure-agent
GitHub stars
305
Token cost
~1.1k tokens
SKILL.md length
377 words
Files
97 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure…

  • Works in 8 steps: Inspect the user input and decide… → If needed, create a brief using… → Choose image, plot, or mixed mode. → …
  • The user needs engineering
  • SKILL.md covers Boundary, Core Decision, Default Workflow and Reference Loading, plus 2 more sections
  • Calls python

What it does

Engineering Figure Agent is an agent skill from heyu-233/engineering-figure-agent. Use when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure briefs, redraws, image edits, or exact publication-style plots from numeric data. Covers Gemini, Nano Banana, OpenAI image models, and local plotting workflows.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 103 other files, including scripts, reference files and assets (for example `.github/workflows/ci.yml`, `README.en.md` and `README.md`).

It sits in Research & Science, covering Data visualization, Image generation and Diagrams. It works with OpenAI and Google Gemini. The repository describes itself as: Engineering Figure Banana is a Codex skill for generating publication-style engineering and computer science figures, with support for Chinese academic papers, bilingual… The licence is MIT.

When your agent uses it

  • The user needs engineering
  • Research-paper figures: system architecture diagrams
  • Algorithm workflows
  • Hardware schematics

Example prompts

  • “/engineering-figure-agent”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the user input and decide whether a figure brief is already present.
  2. If needed, create a brief using references/figure-brief-spec.md.
  3. Choose image, plot, or mixed mode.
  4. For conceptual figures, prefer the prompt-builder scripts; read template references only when you need to inspect or customize template…
  5. For exact plots, create a concise plot request and render it locally.
  6. Keep labels short, claims source-grounded, and outputs publication-oriented.
  7. Save prompt/spec/output paths when files are produced.
  8. Before finishing, run only the checks needed for the touched path.

What it can do on your machine

Read from SKILL.md and the folder at commit a33a553. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Engineering Figure Agent loads about 1.1k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from heyu-233/engineering-figure-agent at commit a33a553, republished under its MIT licence (© heyu-233). 377 words, ~1,147 tokens.

Download SKILL.mdSave it as .claude/skills/engineering-figure-agent/SKILL.md (or your agent's skills folder). This skill also uses 96 other files; get the full folder from GitHub.
name
engineering-figure-agent
description
Use when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure briefs, redraws, image edits, or exact publication-style plots from numeric data. Covers Gemini, Nano Banana, OpenAI image models, and local plotting workflows.

Engineering Figure Agent

Use this skill after the figure goal is already reasonably clear.

Boundary

Good fit:

  • Turn a figure brief into a conceptual diagram, workflow figure, schematic, or exact publication plot.
  • Choose between image, plot, and mixed mode.
  • Build prompts, render plots, and refine existing briefs.

Not the main tool for:

  • Deciding from scratch what claim the paper should visualize.
  • Full paper-argument or reviewer-style critique.

If the user is still deciding the figure claim, panel logic, or caption argument, use an available research-writing or paper-analysis skill upstream first.

Core Decision

  • image mode: conceptual figures, architecture diagrams, algorithm workflows, graphical abstracts, schematics, reference-inspired redraws.
  • plot mode: exact bar charts, trend curves, heatmaps, scatter plots, ablation plots, benchmark summaries.
  • mixed mode: render quantitative panels locally first, then use image generation only for conceptual panels.

Never use image generation for exact values, axes, or benchmark geometry.

Default Workflow

  1. Inspect the user input and decide whether a figure brief is already present.
  2. If needed, create a brief using references/figure-brief-spec.md.
  3. Choose image, plot, or mixed mode.
  4. For conceptual figures, prefer the prompt-builder scripts; read template references only when you need to inspect or customize template wording.
  5. For exact plots, create a concise plot request and render it locally.
  6. Keep labels short, claims source-grounded, and outputs publication-oriented.
  7. Save prompt/spec/output paths when files are produced.
  8. Before finishing, run only the checks needed for the touched path.
Show full SKILL.md (139 more words)Show less

Reference Loading

Read only what is needed:

  • references/figure-brief-spec.md: brief structure and mode rules.
  • references/publication-figure-design.md: publication styling defaults.
  • references/provider-selection.md: Gemini/Banana/OpenAI setup.
  • references/highres-policy.md: high-resolution and fail-closed rules.
  • references/chinese-labels.md: Chinese label readability rules.
  • references/engineering-figure-templates.md and references/materials-science-figure-template.md: template wording when script output needs customization.
  • references/publication-chart-patterns.md, references/natural-language-plot-workflow.md, and references/publication-plot-api.md: exact or plot-heavy workflows.
  • references/editable-figure-handoff.md: optional editable SVG handoff.

Scripts

  • Build a prompt without network calls:
bash
python scripts/build_engineering_figure_prompt.py --figure-template system-architecture --lang en "technical background"
python scripts/build_materials_figure_prompt.py --materials-figure mechanism-figure --lang en "scientific background"
  • Generate or edit a conceptual image:
bash
python scripts/generate_image.py --provider openai --figure-template system-architecture --lang en "technical background"
python scripts/generate_image.py --provider openai --materials-figure mechanism-figure --lang en "scientific background"
  • Render an exact plot:
bash
python scripts/build_plot_spec.py request.json --out spec.json
python scripts/plot_publication_figure.py spec.json --out-path output/figure --formats png pdf svg
  • Use the unified CLI:
bash
python scripts/efa.py prompt --figure-template system-architecture "technical background"
python scripts/efa.py prompt --materials-figure mechanism-figure "scientific background"
python scripts/efa.py plot request.json --out-path output/figure
python scripts/efa.py check

Quality Rules

  • Do not fabricate measurements, benchmark values, hardware specs, or unsupported causal claims.
  • Keep arrows, reading order, and module hierarchy explicit.
  • Favor white backgrounds, publication-style spacing, and readable labels.
  • Use prompt-first workflows when layout fidelity matters.
  • For high-resolution requests, follow references/highres-policy.md.
  • For third-party providers, require explicit opt-in before sending keys or user files.
  • For Chinese figures, preserve standard technical notation when it improves clarity.

© heyu-233, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 96 other files (scripts, references, assets) in the repository root of heyu-233/engineering-figure-agent.

  • SKILL.md
  • .github/workflows/ci.yml
  • .gitignore
  • LICENSE
  • README.en.md
  • README.md
  • README.zh-CN.md
  • adapters/README.md
  • adapters/claude-code/README.md
  • adapters/claude-code/skills
  • agents/openai.yaml
  • assets/prompt-templates/engineering-figure-templates.json
  • assets/prompt-templates/materials-science-figure-templates.json
  • docs
  • … and 83 more

Open the folder on GitHubat commit a33a553

Compare with similar skills

Engineering Figure Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Engineering Figure Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Engineering Figure Agent this skillheyu-233/engineering-figure-agent305—~1.1kAutomated safety check: PassMIT
Paper Figure GenerateGRIND-Lab-Core/night_owl_research_agent106—~5.1kAutomated safety check: NotesNone
Generate ImageK-Dense-AI/claude-scientific-writer2.4k1 repos~3.8kAutomated safety check: NotesMIT
Scientific Schematicsspacering-net/codeg3.9k11 repos~5.9kAutomated safety check: NotesMIT
Scientific SchematicsK-Dense-AI/claude-scientific-writer2.4k1 repos~4.3kAutomated safety check: NotesMIT
Scientific SchematicsK-Dense-AI/scientific-agent-skills48k1 repos~5.1kAutomated safety check: NotesMIT

Similar skills

  • Paper Figure Generate

    GRIND-Lab-Core/night_owl_research_agent

    Generates publication-quality figures and diagrams from output/PAPERPLAN.md for GIScience, GeoAI, and remote sensing journals (IJGIS, ISPRS JPRS, RSE, TGIS).

    106 GitHub stars~5.1k tokensUpdated 5 mo ago
    Media & CreativeAuto-check: notes
  • Generate Image

    K-Dense-AI/claude-scientific-writer

    Generate or edit images with AI models through the OpenRouter Image API (Gemini, Seedream, Recraft, GPT-Image, Riverflow).

    2.4k GitHub starsUsed in 1 repo~3.8k tokens
    Media & CreativeAuto-check: notes
  • Scientific Schematics

    spacering-net/codeg

    Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement.

    3.9k GitHub starsUsed in 11 repos~5.9k tokens
    DevelopmentAuto-check: notes
  • Scientific Schematics

    K-Dense-AI/claude-scientific-writer

    Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement.

    2.4k GitHub starsUsed in 1 repo~4.3k tokens
    Data & AnalyticsAuto-check: notes
  • Scientific Schematics

    K-Dense-AI/scientific-agent-skills

    Generates scientific diagram drafts using Nano Banana 2 AI with smart iterative refinement.

    48k GitHub starsUsed in 1 repo~5.1k tokens
    DevelopmentAuto-check: notes
  • Figure

    Muuuun/luxas

    Hybrid figure pipeline (Nano Banana raster + rembg background removal + TikZ vector assembly).

    1.2k GitHub stars~1.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

Questions about Engineering Figure Agent

What does Engineering Figure Agent do?

A skill your agent uses when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure…. Engineering Figure Agent is an agent skill from heyu-233/engineering-figure-agent. Use when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure briefs, redraws, image edits, or exact publication-style plots from numeric data.

When should I use Engineering Figure Agent?

Engineering Figure Agent fits situations like: the user needs engineering; research-paper figures: system architecture diagrams; algorithm workflows; hardware schematics.

How do I install Engineering Figure Agent in Claude Code?

Run `npx skills add heyu-233/engineering-figure-agent --skill engineering-figure-agent -a claude-code`. Or copy the skill folder (the heyu-233/engineering-figure-agent repository) into .claude/skills/engineering-figure-agent in your project. Claude Code loads it when a task matches its description.

How do I install Engineering Figure Agent in Codex?

Run `npx skills add heyu-233/engineering-figure-agent --skill engineering-figure-agent -a codex`. Or copy the skill folder (the heyu-233/engineering-figure-agent repository) into .agents/skills/engineering-figure-agent in your project. Codex loads it when a task matches its description.

Can I use Engineering Figure Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add heyu-233/engineering-figure-agent --skill engineering-figure-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/engineering-figure-agent, .gemini/skills/engineering-figure-agent, .github/skills/engineering-figure-agent and .opencode/skills/engineering-figure-agent in your project.

What does Engineering Figure Agent need to run?

Going by SKILL.md and its folder, Engineering Figure Agent needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Engineering Figure Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Engineering Figure Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Engineering Figure Agent use?

Engineering Figure Agent is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Engineering Figure Agent use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.

What are the alternatives to Engineering Figure Agent?

Skills that share tags, products or a category with Engineering Figure Agent: Paper Figure Generate (GRIND-Lab-Core/night_owl_research_agent, 106 stars), Generate Image (K-Dense-AI/claude-scientific-writer, 2.4k stars), Scientific Schematics (spacering-net/codeg, 3.9k stars) and Scientific Schematics (K-Dense-AI/claude-scientific-writer, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Engineering Figure Agent?

heyu-233 (a GitHub user) maintains it in heyu-233/engineering-figure-agent, which has 305 GitHub stars. The repository was last updated on May 25, 2026.

Source: heyu-233/engineering-figure-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.