Agent skill

Academic Figure

by joshua-zyy in joshua-zyy/academic-paper-writer

Create, revise, or audit academic data/result figures for CS/AI/ML papers.

Install Academic Figure

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a claude-code

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

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure --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/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/academic-figure .claude/skills/academic-figure && 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/

Paste into Claude Code

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .claude/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/academic-figure .agents/skills/academic-figure && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .agents/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/academic-figure .cursor/skills/academic-figure && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .cursor/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/joshua-zyy/academic-paper-writer.git --path skills/academic-figure

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/academic-figure .gemini/skills/academic-figure && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .gemini/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/academic-figure .github/skills/academic-figure && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .github/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install joshua-zyy/academic-paper-writer academic-figure --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/academic-figure .opencode/skills/academic-figure && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "academic-figure" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-figure into .opencode/skills/academic-figure/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-figure", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: academic-figure
GitHub stars: 115
Token cost: ~816 tokens
SKILL.md length: 274 words
Files: 17 (incl. scripts, references)
Skills in repo: 8
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Create, revise, or audit academic data/result figures for CS/AI/ML papers.

Works in 6 steps: Read manifest.yaml. It declares… → Read every file listed under… → Apply the loaded material as constraints → …
: generating plots from experiment results
SKILL.md covers Router Protocol, Modes, Agent Dispatch and Completion Criteria
Runs Python scripts from its folder

What it does

Academic Figure is an agent skill from joshua-zyy/academic-paper-writer. Create, revise, or audit academic data/result figures for CS/AI/ML papers. Data/result plots default to Python-generated editable SVG with CS/AI/ML-specific design rules for benchmarks, ablations, training dynamics, robustness, diagnostics, distributions, confusion matrices, and efficiency tradeoffs. Use when: generating plots from experiment results or numeric data, auditing publication figures, suggesting data-driven figure types, revising chart colors/layouts/labels, or preparing figure QA reports. Model…

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files, including scripts and reference files (for example `agents/figure_agent.md`, `manifest.yaml` and `references/api.md`).

It sits in Data & Analytics, covering Data visualization, Diagrams and Scientific writing. It works with Python. The repository describes itself as: 面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。 The licence is MIT.

When your agent uses it

: generating plots from experiment results
Auditing publication figures
Suggesting data-driven figure types
Revising chart colors/layouts/labels

Example prompts

“/academic-figure”

Requirements

Python 3

Workflow steps

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

Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
Read every file listed under always_load. These are the skill's binding rules — not reference material.
Apply the loaded material as constraints
Select exactly one mode from the manifest. If ambiguous, ask one concise clarification only when data source or target use is missing…
Echo the selected mode to the user before executing.
Reach for references/ only when the manifest's references.on_demand condition is satisfied.

What it can do on your machine

Read from SKILL.md and the folder at commit 6fceefd. 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 2 files in scripts/ (Python, from the files we listed), which the agent can run.
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

Academic Figure loads about 816 tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 239 tokens; SKILL.md has 274 words of instructions outside code blocks.

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

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 joshua-zyy/academic-paper-writer at commit 6fceefd, republished under its MIT licence (© joshua-zyy). 274 words, ~816 tokens.

Download SKILL.mdSave it as .claude/skills/academic-figure/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.

name: academic-figure
description: Create, revise, or audit academic data/result figures for CS/AI/ML papers. Data/result plots default to Python-generated editable SVG with CS/AI/ML-specific design rules for benchmarks, ablations, training dynamics, robustness, diagnostics, distributions, confusion matrices, and efficiency tradeoffs. Use when: generating plots from experiment results or numeric data, auditing publication figures, suggesting data-driven figure types, revising chart colors/layouts/labels, or preparing figure QA reports. Model framework diagrams, architecture diagrams, overview diagrams, and complex mechanism schematics are outside this skill's automatic drawing scope; provide only manual figure requirements or caption/blueprint notes when needed. Triggers on: 绘图, figure, chart, 画图, 实验图, 训练曲线, 消融实验, 对比图, 混淆矩阵, 结果图, 性能图, 鲁棒性图, 效率图, plot, publication figure, 数据可视化, generate plot, figure blueprint, 建议图表类型, figure audit, 审查图表, figure revision, 修改图表.

Academic Figure

CS/AI/ML academic-figure router. 实验数据图默认交付 Python/matplotlib 可编辑 SVG，并执行 CS/AI/ML 图表设计 gate。模型框架图、架构图、overview 图和复杂机制图不属于本 skill 的自动绘制范围；如论文需要此类图，只能输出人工绘制需求、证据清单、caption 草案或 figure blueprint notes。

Router Protocol

Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
Read every file listed under always_load. These are the skill's binding rules — not reference material.
Apply the loaded material as constraints:
- stance.md defines Python-only plotting, figure contract, visual policy, and scope.
- red-lines.md defines absolute prohibitions. Do not negotiate these.
- output-contract.md defines deliverables per mode.
- anti-patterns.md defines known failure modes and their correct alternatives.
Select exactly one mode from the manifest. If ambiguous, ask one concise clarification only when data source or target use is missing. Requests for model framework, architecture, overview, or mechanism diagrams use figure-blueprint only to produce manual_figure_needed notes; never render images, SVG, or prompts.
Echo the selected mode to the user before executing.
Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Modes

Mode	Use when
`chart-from-data`	Data files or numeric results, needs publication plot with CS/AI/ML chart design gate
`figure-blueprint`	Wants figure suggestions for a paper section
`figure-audit`	Existing figure reviewed for publication readiness
`figure-revision`	Existing figure needs revision

Agent Dispatch

agents/figure_agent.md is dispatched by the orchestrator at Step 6.4. The agent returns figure artifacts, scripts, SVG paths, and reports; it must not independently edit project source code or experimental data.

Completion Criteria

chart-from-data: Figure Contract, CS/AI/ML chart design gate, Python script, source data, editable SVG, QA report — all pass.
figure-audit: Every QA item has pass/fail status and concrete remediation.
figure-blueprint: Every suggested figure maps to a paper claim and data/evidence source.
figure-revision: Revised artifact or instructions, QA report, unchanged evidence traceability.

Files

SKILL.md and 16 other files (scripts, references) in skills/academic-figure of joshua-zyy/academic-paper-writer.

SKILL.md
agents/figure_agent.md
manifest.yaml
references/api.md
references/chart-types.md
references/cs-ai-chart-design-patterns.md
references/design-theory.md
references/figure-contract.md
references/qa-contract.md
references/tutorials.md
references/workflow-chart-from-data.md
scripts/chart_template.py
scripts/qa_figure.py
static/core/anti-patterns.md
static/core/output-contract.md
static/core/red-lines.md
… and 1 more

Open the folder on GitHubat commit 6fceefd

Compare with similar skills

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

Academic Figure compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Academic Figure this skilljoshua-zyy/academic-paper-writer	115	—	~816	Automated safety check: Pass	MIT	6 days ago
Scientific Schematicsjimmc414/Kosmos	595	—	~16k	Automated safety check: Notes	None	2 days ago
Microsim Generatordmccreary/ibook-skills	105	—	~11k	Automated safety check: Pass	None	yesterday
Scientific Figure MakingChenLiu-1996/figures4papers	8.3k	—	~557	Automated safety check: Pass	Custom licence	yesterday
Visualizebrycewang-stanford/Auto-Empirical-Research-Skills	4.6k	—	~1.4k	Automated safety check: Pass	Custom licence	6 days ago
Bio Data Visualization Circos PlotsGPTomics/bioSkills	1.2k	2 repos	~3.4k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

Scientific Schematics
jimmc414/Kosmos
Create publication-quality scientific diagrams, flowcharts, and schematics using Python (graphviz, matplotlib, schemdraw, networkx).
595 GitHub stars~16k tokensUpdated 2 days ago
Data & AnalyticsAuto-check: notes
Microsim Generator
dmccreary/ibook-skills
Creates interactive educational MicroSims, routing to the best-matched generator - p5.js, Chart.js, Plotly, Mermaid, vis-network, timelines, maps, Venn, causal-loop/feedback-loop diagrams (CLD)…
105 GitHub stars~11k tokensUpdated yesterday
Data & AnalyticsAuto-check passed
Scientific Figure Making
ChenLiu-1996/figures4papers
Covers publication-ready matplotlib figures for academic papers, slides, and reports—bars, trends, scatter, heatmaps, and multi-panel layouts—with this…
8.3k GitHub stars~557 tokensUpdated yesterday
Data & AnalyticsAuto-check passed
Visualize
brycewang-stanford/Auto-Empirical-Research-Skills
Create publication-quality figures that meet journal submission standards.
4.6k GitHub stars~1.4k tokensUpdated 6 days ago
Data & AnalyticsAuto-check passed
Bio Data Visualization Circos Plots
GPTomics/bioSkills
Build circular genome visualizations using circlize (R), pyCirclize (Python), or Circos (Perl CLI) with ideogram tracks, multi-data tracks (scatter, histogram, heatmap), chord/link arcs for…
1.2k GitHub starsUsed in 2 repos~3.4k tokens
Data & AnalyticsAuto-check passed
Bio Data Visualization Flow And Transition Plots
GPTomics/bioSkills
Build Sankey, alluvial, river, and CONSORT-style flow diagrams to visualize cohort transitions, cell-state changes, or pipeline filtering using ggalluvial, networkD3, plotly, and consort.
1.2k GitHub starsUsed in 2 repos~2.9k tokens
Data & AnalyticsAuto-check passed

More from joshua-zyy/academic-paper-writer

All 8 skills in this repo

Academic Citation
joshua-zyy/academic-paper-writer
Search, verify, and map citations for CS/AI/ML papers. An agent skill from joshua-zyy/academic-paper-writer.
115 GitHub stars~1.1k tokensUpdated 6 days ago
Auto-check passed
Academic Experiments
joshua-zyy/academic-paper-writer
Audit, run, or verify experimental evidence for CS/AI/ML papers.
115 GitHub stars~754 tokensUpdated 6 days ago
Auto-check passed
Academic Reviser
joshua-zyy/academic-paper-writer
Self-review, audit, or verify CS/AI/ML paper drafts as a critical peer reviewer.
115 GitHub stars~827 tokensUpdated 6 days ago
Auto-check passed
Academic Paper Writer
joshua-zyy/academic-paper-writer
A skill your agent uses when writing or revising CS/AI/ML papers from research notes, code repositories, local literature libraries, target venue requirements, or section-level drafting requests.
115 GitHub stars~1k tokensUpdated 6 days ago
Auto-check passed
Academic Polishing
joshua-zyy/academic-paper-writer
Polish academic prose, de-AI-ify text, control claim strength, or rewrite method sections for CS/AI/ML papers.
115 GitHub stars~780 tokensUpdated 6 days ago
Auto-check passed
Academic Venue Research
joshua-zyy/academic-paper-writer
Research target venue requirements and writing style for CS/AI/ML papers.
115 GitHub stars~626 tokensUpdated 6 days ago
Auto-check passed

Works with

Python

Questions about Academic Figure

What does Academic Figure do?

Create, revise, or audit academic data/result figures for CS/AI/ML papers. Academic Figure is an agent skill from joshua-zyy/academic-paper-writer. Create, revise, or audit academic data/result figures for CS/AI/ML papers.

When should I use Academic Figure?

Academic Figure fits situations like: : generating plots from experiment results; auditing publication figures; suggesting data-driven figure types; revising chart colors/layouts/labels.

How do I install Academic Figure in Claude Code?

Run `npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a claude-code`. Or copy the skill folder (skills/academic-figure in joshua-zyy/academic-paper-writer) into .claude/skills/academic-figure in your project. Claude Code loads it when a task matches its description.

How do I install Academic Figure in Codex?

Run `npx skills add joshua-zyy/academic-paper-writer --skill academic-figure -a codex`. Or copy the skill folder (skills/academic-figure in joshua-zyy/academic-paper-writer) into .agents/skills/academic-figure in your project. Codex loads it when a task matches its description.

Can I use Academic Figure 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 joshua-zyy/academic-paper-writer --skill academic-figure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/academic-figure, .gemini/skills/academic-figure, .github/skills/academic-figure and .opencode/skills/academic-figure in your project.

What does Academic Figure need to run?

Going by SKILL.md and its folder, Academic Figure needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Academic Figure 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 Academic Figure 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 Academic Figure use?

Academic Figure is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Figure use?

About 816 tokens (SKILL.md is roughly 3.3k 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 9.8k tokens, read only when the agent opens those files.

What are the alternatives to Academic Figure?

Skills that share tags, products or a category with Academic Figure: Scientific Schematics (jimmc414/Kosmos, 595 stars), Microsim Generator (dmccreary/ibook-skills, 105 stars), Scientific Figure Making (ChenLiu-1996/figures4papers, 8.3k stars) and Visualize (brycewang-stanford/Auto-Empirical-Research-Skills, 4.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Figure?

joshua-zyy (a GitHub user) maintains it in joshua-zyy/academic-paper-writer, which has 115 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 5, 2026.

Source: joshua-zyy/academic-paper-writer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Academic Figure

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Academic Figure

Router Protocol

Modes

Agent Dispatch

Completion Criteria

Files

Compare with similar skills

Similar skills

More from joshua-zyy/academic-paper-writer

Related

Questions about Academic Figure