Academic Figure

joshua-zyy/academic-figure

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, 修改图表.

19k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

104

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/joshua-zyy/academic-paper-writer --skill academic-figure

What comes with it

70 505 bytes besides the instruction

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

static/core/stance.md

The instruction itself

5 sections, as written by the author

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.

How to use it

Copy the folder

Take joshua-zyy/academic-figure from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.