Agent skill

Figure Spec

by AI4Scientist in AI4Scientist/nano-scientist

Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG.

No licenceAuto-check: notesDevelopment

Install Figure Spec

skills CLI
$ npx skills add AI4Scientist/nano-scientist --skill figure-spec -a claude-code

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

GitHub CLI
$ gh skill install AI4Scientist/nano-scientist figure-spec --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/AI4Scientist/nano-scientist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/figure-spec .claude/skills/figure-spec && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
figure-spec
GitHub stars
128
Used in
2 other repos
Token cost
~2.1k tokens
SKILL.md length
728 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
None found

At a glance

Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG.

  • Works in 5 steps: Understand the Diagram Goal → Draft the FigureSpec JSON → Render and Validate → …
  • Draw architecture
  • SKILL.md covers When to Use This Skill, Core Properties, Tool Location and Workflow, plus 6 more sections
  • Calls python3

What it does

Figure Spec is an agent skill from AI4Scientist/nano-scientist. Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG. Use when user says "架构图", "workflow 图", "pipeline 图", "确定性矢量图", "figure spec", "draw architecture", or needs precise, editable, publication-ready vector diagrams. Preferred over AI illustration for formal architecture/workflow figures.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Diagrams and Data visualization. The repository describes itself as: An autonomous research agent that turns a topic into a peer-reviewed technical report.

When your agent uses it

  • Draw architecture
  • Publication-ready vector diagrams

Example prompts

  • “workflow 图”
  • “pipeline 图”
  • “确定性矢量图”
  • “/figure-spec”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(*), Read, Write, Edit

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Understand the Diagram Goal
  2. Draft the FigureSpec JSON
  3. Render and Validate
  4. Visual Review
  5. Iterate with Codex Review (Optional, for High-Stakes Figures)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    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

Figure Spec loads about 2.1k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 728 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Write, Edit

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 728 words (~2,145 tokens).

“Generate publication-quality architecture diagrams, workflow pipelines, audit cascades, and system topology figures as editable SVG vector graphics using a deterministic JSON → SVG renderer.”

— opening of SKILL.md by AI4Scientist
name
figure-spec
allowed-tools
Bash(*), Read, Write, Edit
argument-hint
description-of-diagram

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/figure-spec of AI4Scientist/nano-scientist.

Open the folder on GitHubat commit 7132192

Used in 2 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AI4Scientist/nano-scientist, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Figure Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Figure Spec this skillAI4Scientist/nano-scientist1282 repos~2.1kAutomated safety check: NotesNone
Diagram Designcathrynlavery/diagram-design47k1 repos~7.5kAutomated safety check: PassMIT
Scientific Schematicsspacering-net/codeg3.9k11 repos~5.9kAutomated safety check: NotesMIT
Antv G2 Chartantvis/chart-visualization-skills506—~2.5kAutomated safety check: PassMIT
Opencharttryopendata/skills142—~11kAutomated safety check: PassMIT
Fireworks Tech GraphCitrus-bit/Anaxa120—~5.4kAutomated safety check: PassMIT

Similar skills

  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    47k GitHub starsUsed in 1 repo~7.5k tokens
    DevelopmentAuto-check passed
  • 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
  • Antv G2 Chart

    antvis/chart-visualization-skills

    A skill your agent uses whenever the user wants to create, customize, or troubleshoot G2 v5 chart visualizations.

    506 GitHub stars~2.5k tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • Openchart

    tryopendata/skills

    Generates OpenChart (https://github.com/tryopendata/openchart) chart, table, graph, sankey, tilemap, and geo map specs from data, and guides editorial design decisions.

    142 GitHub stars~11k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Fireworks Tech Graph

    Citrus-bit/Anaxa

    A skill your agent uses when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG.

    120 GitHub stars~5.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Markdown Mermaid Writing

    K-Dense-AI/scientific-agent-skills

    Writes scientific Markdown documentation and Mermaid diagrams for workflows, relationships, timelines, and schemas.

    48k GitHub starsUsed in 1 repo~4.2k tokens
    DevelopmentAuto-check: notes

More from AI4Scientist/nano-scientist

All 74 skills in this repo
  • Formula Derivation

    AI4Scientist/nano-scientist

    Structures and derives research formulas when the user wants to 推导公式, build a theory line, organize assumptions, turn scattered equations into a coherent derivation, or rewrite theory notes into a…

    128 GitHub starsUsed in 5 repos~2.3k tokens
    Auto-check passed
  • Paper Compile

    AI4Scientist/nano-scientist

    Compile LaTeX paper to PDF, fix errors, and verify output. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~2.5k tokens
    Auto-check: notes
  • Paper Figure

    AI4Scientist/nano-scientist

    Generate publication-quality figures and tables from experiment results.

    128 GitHub starsUsed in 5 repos~2.9k tokens
    Auto-check: notes
  • Paper Navigator

    AI4Scientist/nano-scientist

    Find and read academic papers: disambiguate queries, discover papers (search, citation traversal, recommendations, arXiv monitoring, trending, GitHub search), evaluate (TLDR, citations, code, SOTA)…

    128 GitHub stars~7.7k tokensUpdated 4 mo ago
    Auto-check: notes
  • Proof Writer

    AI4Scientist/nano-scientist

    Writes rigorous mathematical proofs for ML/AI theory. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Ablation Planner

    AI4Scientist/nano-scientist

    A skill your agent uses when main results pass result-to-claim (claimsupported=yes or partial) and ablation studies are needed for paper submission.

    128 GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check: notes

Categories

Questions about Figure Spec

What does Figure Spec do?

Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG. Figure Spec is an agent skill from AI4Scientist/nano-scientist. Generate deterministic publication-quality architecture, workflow, and pipeline diagrams from structured JSON (FigureSpec) into editable SVG.

When should I use Figure Spec?

Figure Spec fits situations like: draw architecture; publication-ready vector diagrams.

How do I install Figure Spec in Claude Code?

Run `npx skills add AI4Scientist/nano-scientist --skill figure-spec -a claude-code`. Or copy the skill folder (skills/figure-spec in AI4Scientist/nano-scientist) into .claude/skills/figure-spec in your project. Claude Code loads it when a task matches its description.

How do I install Figure Spec in Codex?

Run `npx skills add AI4Scientist/nano-scientist --skill figure-spec -a codex`. Or copy the skill folder (skills/figure-spec in AI4Scientist/nano-scientist) into .agents/skills/figure-spec in your project. Codex loads it when a task matches its description.

Can I use Figure Spec 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 AI4Scientist/nano-scientist --skill figure-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/figure-spec, .gemini/skills/figure-spec, .github/skills/figure-spec and .opencode/skills/figure-spec in your project.

What does Figure Spec need to run?

Going by SKILL.md and its folder, Figure Spec needs the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(*), Read, Write, Edit.

Does Figure Spec 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 Figure Spec safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Figure Spec use?

No licence was found for Figure Spec or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Figure Spec use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Figure Spec?

Skills that share tags, products or a category with Figure Spec: Diagram Design (cathrynlavery/diagram-design, 47k stars), Scientific Schematics (spacering-net/codeg, 3.9k stars), Antv G2 Chart (antvis/chart-visualization-skills, 506 stars) and Openchart (tryopendata/skills, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Figure Spec?

AI4Scientist (a GitHub organization) maintains it in AI4Scientist/nano-scientist, which has 128 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on June 3, 2026.

Source: AI4Scientist/nano-scientist on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.