engineering-figure-table
Plan, revise, audit, or polish figures, tables, captions, table notes, and visual evidence flow for English engineering conference or journal papers. Use when the user asks about figure responsibility
SKILL.mdskills/engineering-figure-table/SKILL.md
GitHubEngineering Figure Table
Use this skill to make figures and tables serve the manuscript argument.
Core Stance
- Define visual responsibility before visual styling.
- A figure or table should carry a specific claim, setup fact, evidence axis, or reader action.
- Do not let captions claim what the visual does not show.
- Visuals can illustrate mechanisms, but they cannot prove hidden mechanisms without direct visual, tabular, or experimental evidence.
- Do not use tables as unstructured parameter dumps unless the table's job is setup compression.
- Keep category names, metric names, captions, and prose consistent.
- Give each float one job. Showing the same data as a trend and as exact values is fine; showing it twice for the same purpose is not. Split the main comparison and the ablation when combining them makes either harder to read (P9 in reviewer-attack-patterns.md).
- Make colors semantic (for example success versus failure), and keep one table style across the paper.
- A teaser figure stays light, the framework figure carries the method, and qualitative result figures show representative cases chosen by a stated criterion, including observed failures (step 5 in writing-process.md).
- Number floats in the order they are first referenced in the text (P7).
Boundaries
- Use
engineering-writingwhen the user needs section prose around the visual evidence. - Use
engineering-polishingfor prose-only clarity or style work. - Use
engineering-responsewhen visual changes are driven by reviewer or advisor comments. - Use
engineering-validationfor final label/reference/build consistency before claiming submission readiness.
When to Open Extra Files
| File | Open when |
|---|---|
| references/visual-contract.md | Planning figure/table responsibility or deciding which visuals are needed |
| references/figure-roles.md | Deciding what motivation, framework, workflow, gallery, or evidence figures should do |
| references/captions.md | Writing or auditing captions and table notes |
| references/tables.md | Designing setup, main results, ablation, or stress-test tables |
| references/panel-claim-map.md | Mapping every panel, row, or column to a manuscript claim |
| references/figure-source-data-consistency.md | Checking that plotted values, source data, captions, and prose agree |
| references/venue-figure-standards.md | Target venue family changes figure resolution, source data, or caption expectations |
| references/consistency.md | Checking category names, metrics, labels, caption style, and prose alignment |
| references/page-budget.md | Cutting visual space, caption length, or table detail without damaging evidence |
| references/examples.md | Needing concrete figure/table role examples and caption behavior |
| references/failure-modes.md | Handling captions or tables that claim more than the visual supports |
| ../_shared/evidence-boundary.md | Visual claims may exceed visible or tabulated evidence |
| ../_shared/claim-strength.md | Caption or table note verbs may overstate what is visible |
| ../_shared/output-mode.md | The user asks for caption/table output only |
| ../_shared/terminology-ledger.md | Category, metric, object, or method names change across visuals and prose |
Workflow
- State the paper claim the visual supports.
- Assign one responsibility to each figure/table.
- Map each panel, row, or column to a piece of evidence.
- Check source-data and caption consistency when values, metrics, or panels are provided.
- Check whether the caption states only visible or tabulated information.
- Check consistency across prose, caption, labels, and notes.
- Check whether any category/metric rename needs coordinated changes.
- Remove or redesign a visual if it has no claim, setup fact, evidence axis, or reader action.
- If editing LaTeX, preserve labels and references unless there is a direct reason to change them.
Default Output
Visual audit
| Item | Responsibility | Visible/tabulated evidence | Claim supported | Must not claim | Placement | Related prose action | Risk | Action |
Panel-claim map
| Panel/row/column | Claim served | Evidence shown | Source-data check | Caption boundary |
Caption/table revision
[English caption or table plan]
Consistency actions
- labels:
- category names:
- metric names:
- prose references: