review-figures-and-tables
Skill2 starsChanged 36 days agoMITView on GitHub
Plans original figures and synthesis tables for a review and records each item as original, adapted, or reused. Use when the user says "figure plan", "Fig. 1", "synthesis table", "comparison matrix", "figure ledger", or "permission status", "draw the original figures", or "crop a panel". Do not use to download a PDF. Crop only a local PDF already in the project, and only through the crop ledger. Permission requests belong to figure-permissions.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .cursor/rules/literature-review.mdcCursor rule
- exemplar-review-analysisSkill
- figure-permissionsSkill
- journal-selectionSkill
- literature-screeningSkill
- manuscript-polishingSkill
- paper-deep-readingSkill
- reviewer-responseSkill
- review-orchestratorSkill
- review-outline-builderSkill
- review-project-setupSkill
- review-scoping-and-gapsSkill
- review-section-drafterSkill
- review-writingSkill
- search-export-and-dedupSkill
- search-strategy-builderSkill
- submission-packageSkill
- zotero-library-syncSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. About 0 are common, 6 are distinctive, and 11 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 36
Read every Figures/tables bullet in the outline.
- Very specific: line 37
Create <project>/08-figures/figure_plan.md.
- Distinctive: line 44
Prefer original schematics and synthesis tables.
- Very specific: line 49
Write <project>/08-figures/figure_ledger.csv with this header:
- Very specific: line 69
Read the license on the version-of-record HTML page.
- Very specific: line 72
Every other resolved license uses needed, requested, or granted.
- Very specific: line 112
If any row is adapted or reused, or any crop row is needs-permission, show the user the row and ask whether to pursue permission or replace …
- Very specific: line 122
No project-level lock. Stop and ask when any ledger row is adapted or reused, or any crop row is needs-permission, because that commits the …
- Distinctive: line 135
Every plan heading has one ledger row, and every ledger id has a plan section.
- Distinctive: line 136
Every original ledger row has an SVG and a PDF that contain that item's evidence IDs.
- Very specific: line 137
No row cites a paper that is missing from the evidence table.
- Distinctive: line 143
Do not download a paper to crop it.
- Distinctive: line 144
Do not crop the same source panel into two files.
- Very specific: line 145
Do not paste a published figure into the project, or trace it, outside crop_panels.py and the ledger.
- Very specific: line 146
Do not set license to a Creative Commons code you did not read on the version of record.
- Very specific: line 147
Do not write Reproduced from or Adapted from until the source citation and the license are both known.
- Distinctive: line 148
Do not send permission email in this skill.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Review figures and tables
Opening
On first use in a project, say this verbatim:
I am review figures and tables. Original drawings stay SVG and PDF, and a published panel is cropped only from a PDF you already have, with a crop ledger.
When to use
The outline is locked. You are deciding what art and tables the review will contain, then drawing each original item as an editable SVG plus a PDF. A published panel may be cropped only from a PDF the user already has, with one row in panel_crop_ledger.csv. Adapted and reused items that are not cropped here stay in the figure ledger for figure-permissions.
Inputs (paths) / Preconditions
<project>/07-outline/outline.mdwithStatus: locked. If it is stilldraft, stop and return toreview-outline-builder.<project>/evidence/evidence_table.csv<project>/05-reading/notes, including any quotable figure ideas already recorded there.shared/writing_rules.md
<suite> is this skill's suite directory. <project> is the review folder.
Procedure (numbered steps)
- Read every
Figures/tablesbullet in the outline. AddFig. 1if the outline forgot it. Fig. 1 is an original conceptual overview of this review's argument. It is not a redraw of a published graphical abstract. - Create
<project>/08-figures/figure_plan.md. Give each item a heading (## Fig. 1,## Table 1,## Box 1) and these bullets:Message:one sentence the reader should remember.Type:original,adapted, orreused.Evidence IDs:IDs that justify the content. For original items this is the evidence the drawing is based on, not a source being copied.Panels or columns:what each panel or column shows, in words.Do not copy:the published figure or table, if any, that this item must not reproduce. Writenoneonly when you are not looking at a published graphic.File:the later image or table filename, ornot drawn yet.
- Prefer original schematics and synthesis tables. A synthesis table compares evidence rows in columns you define (study, design, population, finding, limitation). It does not paste a published table.
- Classify before you describe the graphic:
original— you are not reproducing someone else's arrangement, artwork, or table layout. Facts and methods may be restated. Copyright protects expression, not the underlying facts (https://www.copyright.gov/circs/circ01.pdf).adapted— a reader would recognize the source graphic, including a close redraw.reused— the published image or table would be inserted.
- Write
<project>/08-figures/figure_ledger.csvwith this header:
id,type,sources,license,permission_status,caption_creditOptional columns, only if you have them: title, license_url, notes.
Controlled values:
| Column | Allowed values |
| id | Fig. 1, Fig. 2, Table 1, Box 1 (optional panel letter, as in Fig. 2a) |
| type | original, adapted, reused |
| sources | none for original; otherwise include an evidence ID (E014) plus the figure or table number in that paper |
| license | original, cc-by, cc-by-sa, cc-by-nc, cc-by-nc-sa, cc-by-nd, cc-by-nc-nd, cc0, public-domain, publisher-owned, own-previous, unknown |
| permission_status | not_required, needed, requested, granted |
| caption_credit | Created for this review. / Reproduced from ... / Adapted from ... / PENDING |
- License rules for the ledger:
- Read the license on the version-of-record HTML page. If you have not opened that page, the license is
unknown, the status isneeded, and the credit isPENDING. Do not guesscc-bybecause the journal is open access. own-previousmeans you have not yet classified the old paper's version-of-record license. Leave itneeded/PENDINGuntil you do. Your own copyright transfer does not make the figure free to reuse.cc-by,cc0, andpublic-domainmay usenot_requiredonce the credit line is final.cc-by-ndmay usenot_requiredonly for unmodifiedreuseditems.- Every other resolved license uses
needed,requested, orgranted.grantedrequires a final credit line, notPENDING. license_url, when present, is the Creative Commons deed you opened (https://creativecommons.org/licenses/) or the publisher page. No shadow-library URLs.
- Read the license on the version-of-record HTML page. If you have not opened that page, the license is
- Examples that pass the checker are in
references/figure_ledger_example.csvandreferences/figure_ledger_adapted_example.csv. Replace the sampleE010and the sample citation. Do not ship those names. - Run:
python3 <suite>/skills/review-figures-and-tables/scripts/validate_ledger.py \
<project>/08-figures/figure_ledger.csv \
--evidence <project>/evidence/evidence_table.csv--strict is for later, at submission. Do not use it while a row is still needed.
- Draw every
originalitem. The script writes08-figures/fig-1.svgandfig-1.pdf(andtable-1,box-1, and panel letters the same way). Fig. 1 is an argument map. Tables and boxes are column schematics, not copied cells. Adapted and reused rows are skipped.draw_originals.pystill refuses a message that asks it to crop. Cropping is the next step, not this command.
python3 <suite>/skills/review-figures-and-tables/scripts/draw_originals.py \
--plan <project>/08-figures/figure_plan.md \
--ledger <project>/08-figures/figure_ledger.csv \
--out <project>/08-figuresThe command must print OK originals. Then set each original item's File: bullet to its .svg path. Evidence IDs from the plan are written into the SVG and the PDF.
- Crop a published panel only when the user already has the PDF. Write
08-figures/panel_crop_ledger.csvwith this header:
figure_id,panel_id,source_pdf,page,original_figure,crop_box,copyright_status,used_insource_pdf is a local path. crop_box is x0,y0,x1,y1 in PDF points. copyright_status is cc-by, cc-by-nc, publisher-permission-granted, or needs-permission. The same source PDF, page, original figure, and crop box cannot appear twice. An empty or missing ledger writes nothing. needs-permission is not a publication file until figure-permissions changes that status. Do not download the PDF.
python3 <suite>/skills/review-figures-and-tables/scripts/crop_panels.py \
--ledger <project>/08-figures/panel_crop_ledger.csv \
--out <project>/08-figures/cropsOK panel crops is required before those files are cited. If crop_blocked.tsv exists, submission waits.
- If any row is
adaptedorreused, or any crop row isneeds-permission, show the user the row and ask whether to pursue permission or replace it with an original. Record the answer inLOG.md:
YYYY-MM-DD | review-figures-and-tables | Fig. 2 will be requested or replaced | human
- Append a one-line decision for the plan itself:
YYYY-MM-DD | review-figures-and-tables | figure plan written, N items | agent
Human gate(s)
No project-level lock. Stop and ask when any ledger row is adapted or reused, or any crop row is needs-permission, because that commits the user to a permissions request or a replacement. Do not tell the user a publisher has granted permission.
Outputs (exact paths + formats)
<project>/08-figures/figure_plan.md— one section per item, bullets listed above.<project>/08-figures/figure_ledger.csv— header and values in step 5.<project>/08-figures/<slug>.svgand<slug>.pdffor each original item (Fig. 1isfig-1).<project>/08-figures/panel_crop_ledger.csvand08-figures/crops/when a published panel is cropped.
Quality checklist
validate_ledger.pyprintsOK ledgeranddraw_originals.pyprintsOK originals.Fig. 1exists, isoriginal, and its SVG saysargument map.- Every plan heading has one ledger row, and every ledger id has a plan section.
- Every original ledger row has an SVG and a PDF that contain that item's evidence IDs.
- No row cites a paper that is missing from the evidence table. Add the paper through
paper-deep-readingfirst; do not invent a row. - Caption credits do not say "with permission" unless
permission_statusisgranted. - A cropped file exists only when
crop_panels.pyprintedOK panel cropsfor a ledger whose source PDFs are local. No file was downloaded from a search engine or a shadow library.
Guardrails
- Do not download a paper to crop it. The source PDF must already be on disk.
- Do not crop the same source panel into two files.
- Do not paste a published figure into the project, or trace it, outside
crop_panels.pyand the ledger. - Do not set
licenseto a Creative Commons code you did not read on the version of record. - Do not write
Reproduced fromorAdapted fromuntil the source citation and the license are both known. Until then the credit cell isPENDING. - Do not send permission email in this skill.
Next step
review-section-drafter. If any row is adapted or reused, also open figure-permissions now so the request is not left until submission.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

