本文へ移動
cccskills
無料GitHub で公開

figure-table-audit

End-stage QA for a finished figure and table set (callouts, numbering, cross-references, text-to-exhibit consistency, captions and notes, accessibility, SI and replication linkage). Use when preparing a submission.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.2 KB
  • agents/openai.yaml258 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Figure and Table Auditor

The end-stage auditor for a stable figure and table set, run before submission. Design and production guidance during drafting lives in figures and tables. When a claim depends on values plotted in an image, check it against the source data, or mark it for author verification; do not estimate values by eye.

Adapted for open-science social-science manuscripts from figure, table, and citation-compliance ideas in Cheng-I Wu's Academic Research Skills for Claude Code (CC BY-NC 4.0).

Instructions

1. Orient before auditing

Identify:

  • Manuscript source and compiled output, if any.
  • Figure directory, table files, appendix/SI files, and build command.
  • Target journal or style guide.
  • Whether figures are generated from code, manually edited, or exported from software.
  • Whether source data for figures/tables are available.

If only a PDF is available, state that cross-reference and value checks are lower confidence.

2. Inventory figures and tables

Build an inventory with:

  • Figure/table number or label.
  • File path or source location.
  • Caption/title.
  • First in-text callout.
  • Appendix/SI location if applicable.
  • Producing script or data source, if visible.

Check:

  • Every in-text callout resolves to an existing figure/table.
  • Every figure/table is called out in text before or near appearance.
  • Numbering is gap-free and not duplicated.
  • Main-text and SI labels do not collide.
  • LaTeX/Markdown references compile without unresolved labels.

3. Check text-to-evidence consistency

For each figure/table used to support a substantive claim:

  • Match the in-text claim to the exact row, column, panel, model, or plotted quantity, and name it in the finding.
  • Verify direction, magnitude, uncertainty, subgroup, and denominator.
  • Check whether text overstates non-significant or imprecise estimates.
  • Check whether figure/table notes disclose model specification, N, weights, fixed effects, clustering, and missing-data handling.
  • For experimental papers, check ITT vs per-protocol labeling, attrition-by-arm, baseline balance, and CONSORT/sample-flow consistency.

Read exact values from a plot only when the figure labels them. If source data are unavailable, write VISUAL READ ONLY - AUTHOR VERIFY.

4. Audit captions and notes

Captions and table notes should let a reader understand the evidence without hunting:

  • Figure caption states what is plotted, units, sample, uncertainty interval, and panel meanings.
  • Table title states the estimand or model family, not only "Results."
  • Table notes define dependent variable, treatment/condition coding, omitted categories, controls, fixed effects, clustering, weights, and significance markers.
  • All abbreviations are defined on first use.
  • All transformations, scales, and index directions are explicit.
  • Any data exclusions or subgroup restrictions are named.

For conjoint, list-experiment, topic-modeling, text-classification, and OCR studies, invoke or recommend the relevant sibling skill when table/figure interpretation depends on method-specific standards.

5. Check accessibility and production quality

Flag:

  • Color palettes not interpretable in grayscale or by color-blind readers.
  • Low-resolution or rasterized text in vector outputs.
  • Axis labels too small or missing units.
  • Legends that obscure data or use ambiguous labels.
  • Inconsistent decimal precision.
  • Overcrowded tables that should move to SI.
  • Missing alt text when the target venue requires it.
  • Non-reproducible manual edits that are not documented.

6. Audit SI and replication linkage

Check whether:

  • Main-text claims that point to SI land on the correct appendix/table/figure.
  • SI numbering and captions are internally consistent.
  • Each main figure/table can be traced to a script or documented manual step.
  • Replication README maps outputs to scripts and data files.
  • Figure/table source data are archived or clearly restricted.

Output

Produce a Figure and Table Audit Report:

# Figure and Table Audit Report

Scope:
Inputs checked:
Build/source status:
Summary: <N blocking, N recommended, N minor, N author-verification>

## Inventory
| ID | Path/location | Caption/title | First callout | Source/script |

## Blocking Issues
| Location | Figure/table | Issue | Evidence | Fix |

## Recommended Fixes
| Location | Figure/table | Issue | Fix |

## Minor / Production Issues
| Figure/table | Issue | Fix |

## Author Verification Needed
| Figure/table | Why verification is needed |

## Readiness Checklist
| Dimension | PASS/FAIL/PARTIAL/NA | Notes |

Severity:

  • Blocking: missing figure/table, wrong referenced value, denominator mismatch, unresolved label, table contradicts text, missing sample-flow evidence for experimental paper, or non-reproducible main result output.
  • Recommended: incomplete notes, unclear captions, missing units, missing source script, accessibility problem, imprecise uncertainty reporting.
  • Minor: style, spacing, decimal precision, typography, cosmetic consistency.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

advisor

無料

Consults Fable as an independent, read-only reviewer at an effort the caller matches to the question. The calling session (usually Opus, or Haiku) holds the task and escalates one decision point. Use before committing to an interpretation or a substantial piece of writing or analysis, when stuck or not converging, when changing approach, or as a final check on a finished task. Fallback for when the native advisor tool is unavailable. Not for a session already running Fable.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

advisor

無料

Consult an independent, read-only GPT-6 Astra advisor before committing to a substantive interpretation, approach, or final result. Not for routine work, implementation, or file edits. Uses gpt-6-astra at an effort matched to the question.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

beamer

無料

House rules and craft for LaTeX Beamer decks (storyboarding, slide prose, frame budgets, layout, XeLaTeX and Korean fonts, color, figures, Overleaf hygiene, build QA). Use to write, edit, review, or build a Beamer deck.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

beamer

無料

House rules and craft for LaTeX Beamer slide decks (lectures, seminars, talks), drawn from the author's own Overleaf edits and published slide-design guidance. Covers storyboarding, frame titles, slide prose, word and frame budgets, layout without overfull boxes, XeLaTeX fonts and Korean (xeCJK), color, figures and screenshots, Overleaf source hygiene, speaker notes, and a build-and-QA loop with a contact sheet. Use when writing, editing, reviewing, or building a Beamer deck, theme, or storyboard. A course skill supplies course facts and the frame skeleton; this skill supplies the craft. Not for HTML or PowerPoint decks, posters, or papers.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

Audits a manuscript's citations for fabricated or nonexistent sources, DOIs that resolve to a different work, mismatches between in-text citations and the reference list, APA 7 or journal style, and whether each source supports the claim it is attached to. Checks entries against Crossref, OpenAlex, and DataCite and labels anything it could not verify NOT CHECKED. Use to check citations, references, a .bib file, or DOIs, or when a source may be AI-invented. Figures and tables go to figure-table-audit.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

Audit a manuscript's citations for fabricated sources, DOIs that resolve to the wrong work, in-text and reference-list mismatches, style, and claim support, verified against Crossref and OpenAlex. Use to check citations, references, a .bib file, or DOIs.

日本語の概要は準備中です。原文の説明を表示しています。

scdenney/open-science-skills652026年10月8日 更新

scdenney のスキルをすべて見る

このスキルの問題を報告する