# Paper Framework Figure

> Use when creating, designing, or improving a framework, overview, architecture, system model, pipeline, teaser, or comparison figure in an academic paper. This umbrella skill routes to focused figure modules for Introduction teaser figures, Methods pipeline or architecture figures, IEEE system model figures, comparison or motivation figures, multi-panel layouts, captions, and LaTeX integration, with a Python-first workflow that generates editable SVG and companion PDF outputs without external GUI tools.

- Skill: `terryzhang95/paper-framework-figure` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add terryzhang95/paper-framework-figure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/terryzhang95/paper-framework-figure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: MIT
- Author: terryzhang95 (https://skillmd.com/u/terryzhang95)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/terryzhang95/paper-framework-figure

---


# Paper Framework Figure

Umbrella skill for academic structural figures. Use it to classify the figure job first, then load only the modules needed for that job.

This skill is for **conceptual / structural figures**:
- framework or overview figures
- teaser figures in the Introduction
- method pipelines and workflow diagrams
- architecture figures
- system model figures
- comparison or motivation figures
- multi-panel structural layouts

This skill is **not** for experimental plots such as curves, bar charts, histograms, CDFs, or ablations shown as data plots.

## Design Logic

Do not treat all paper figures as one task. The correct design depends on:
- the figure's rhetorical role
- the paper section where it appears
- the venue style
- the required SVG structure and PDF placement constraints

Use this skill as a router:
1. Identify the figure's primary role.
2. Load the matching function module from `references/`.
3. Load cross-cutting modules only if needed.
4. Use a Python-first workflow that produces an editable SVG as the source artifact.
5. Export a companion PDF for paper integration.
6. Produce the figure spec, implementation guidance, caption, and integration guidance.

If a figure seems to do multiple jobs, pick **one primary message** and route by that. If needed, load one secondary module, but do not merge several independent stories into one overloaded figure.

## Routing

### Choose by Figure Function First

| Primary role | Typical section | Load this module |
|---|---|---|
| Teaser / paper-level overview | Introduction, Fig. 1 | `references/teaser-overview.md` |
| Method pipeline / workflow | Start of Methods | `references/pipeline-workflow.md` |
| Model architecture / component interaction | Methods / Model | `references/architecture.md` |
| IEEE-style topology / geometry / network setup | System Model | `references/system-model.md` |
| Comparison / motivation / before-vs-after | Introduction / Related Work / Methods | `references/comparison-motivation.md` |
| Multi-panel structural figure | Any section | `references/multi-panel-layout.md` |

### Load Cross-Cutting Modules as Needed

- `references/foundations.md`
  Use for universal rules, layout, color, venue constraints, and tool selection.
- `references/python-svg-workflow.md`
  Use by default for the Python-first tool stack, editable SVG workflow, and PDF export path.
- `references/icon-and-assets.md`
  Use when the figure needs icons, imported SVG assets, or illustration sourcing rules.
- `references/captioning-and-integration.md`
  Use when writing captions, checking notation consistency, exporting, or integrating into LaTeX.
- `references/quality-checklist.md`
  Use during review, refinement, or pre-submission checking.

## Section-Aware Defaults

Paper section is a routing hint, not the main taxonomy:
- **Introduction** usually maps to `teaser-overview.md` or `comparison-motivation.md`.
- **Methods** usually maps to `pipeline-workflow.md` or `architecture.md`.
- **System Model** usually maps to `system-model.md`.
- **Results / Discussion** only use this skill when the figure is conceptual rather than data-driven.

## Working Procedure

### Step 1: Classify the Request

Extract:
- venue or target style: ML/AI, IEEE, or general
- section placement: Introduction, Methods, System Model, etc.
- figure function: teaser, pipeline, architecture, topology, comparison
- required output medium: editable SVG source plus exported PDF

### Step 2: Load the Minimum Modules

Always start with:
- `references/foundations.md`
- `references/python-svg-workflow.md`

Then load one primary function module. Add only the extra modules needed for:
- multi-panel composition
- icons and sourced assets
- captions and integration
- quality review

### Step 3: Choose the Tool Deliberately

Default policy:
- Prefer **Python scripts** to define structure, layout, and repeated geometry.
- Use **editable SVG** as the primary figure artifact.
- Export **PDF** from the SVG output for paper integration.
- Do not route to TikZ or external GUI editors in the normal workflow.

### Step 4: Produce a Figure Specification

Before drawing, define:
- the single takeaway
- the figure structure and panel plan
- the semantic meaning of boxes, arrows, colors, and enclosures
- the caption outline
- target width and export format

### Step 5: Validate Before Finalizing

Check:
- one figure, one message
- caption is self-contained
- no title text inside the figure
- font size is readable
- symbols match the paper
- width fits the venue
- output is vector unless raster is explicitly required

## Non-Negotiable Rules

These apply across all modules:
- A framework figure must communicate without surrounding text.
- Caption must do the title's job; do not place a title inside the figure.
- Do not encode meaning by color alone.
- Keep flow left-to-right or top-to-bottom unless topology dictates otherwise.
- Use vector output for structural figures whenever possible.
- Keep visual hierarchy explicit: primary components stronger than secondary ones.
- Keep arrow semantics consistent within one figure.

## Deliverables

Depending on the request, the output should include some or all of:
- figure concept or layout spec
- Python-first implementation recommendation
- box / arrow / panel semantics
- caption draft
- editable SVG generation guidance
- export and LaTeX integration instructions

## Reference Map

- `references/foundations.md` - global rules, tool selection, venue styling
- `references/python-svg-workflow.md` - default Python-first workflow, editable SVG generation, and PDF export
- `references/teaser-overview.md` - Fig. 1 teaser and paper-level overview figures
- `references/pipeline-workflow.md` - staged method pipelines and workflows
- `references/architecture.md` - component diagrams and model structures
- `references/system-model.md` - IEEE topology and geometry figures
- `references/comparison-motivation.md` - prior-vs-ours and problem-motivation figures
- `references/multi-panel-layout.md` - panel composition across figure types
- `references/captioning-and-integration.md` - captions, notation, export, LaTeX placement
- `references/icon-and-assets.md` - icons, SVG assets, and visual asset sourcing
- `references/quality-checklist.md` - common failure modes and pre-submission checks