Skip to content

gpsaggese/helpers / .claude/skills/paper.fix_figures

paper.fix_figures

Verified

Add labels, captions, and text references to every figure in a LaTeX paper

Check References

  • Every picture and table needs a label and a caption, and must be referenced in the text
  • Captions should only say what is done. Comments and other content go in the text

Add Captions and Labels

  • For all figures in the LaTeX files in the passed dir, add the caption and label to the commented section.

  • For instance convert

    %     ```
    % rendered_images:end
    % render_images:begin
    \begin{figure}[!ht]
      \centering
      \includegraphics[width=\linewidth]{figs/02_architecture.1.png}
      \caption{Confounding adjustment in causal inference}
      \label{fig:confounding_adjustment}
    \end{figure}
    % render_images:end
    

    to

    %     ```
    % caption=Confounding adjustment in causal inference
    % label=fig:confounding_adjustment
    % rendered_images:end
    % render_images:begin
    \begin{figure}[!ht]
      \centering
      \includegraphics[width=\linewidth]{figs/02_architecture.1.png}
      \caption{Confounding adjustment in causal inference}
      \label{fig:confounding_adjustment}
    \end{figure}
    % render_images:end
    

Create Labels and Captions From Scratch

  • If a figure has no caption or label, infer them from the filename and surrounding context
    • E.g., figs/02_architecture.1.png becomes label=fig:architecture, caption=System architecture overview
  • Use short, lowercase label names with underscores

Add References in the Text

  • If a figure has a label but no citation in the text, add a parenthetical reference near the most relevant paragraph:
    (see Fig.~\ref{fig:confounding_adjustment})
    

Verify No Orphaned References

  • Scan the text for \ref{fig:xxx} or \ref{tab:xxx} with no matching \label in any figure or table environment
  • Report orphaned references as warnings. Do not silently delete them

Verification

  • Every figure and table has a \label and a \caption
  • Every figure and table \label is referenced by a \ref in the text
  • No orphaned \ref{fig:xxx} or \ref{tab:xxx} exists without a matching \label in any figure or table environment
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 114kUpdated Claude CodeCodexVerifiedInstall