gpsaggese/helpers / .claude/skills/paper.fix_figures
paper.fix_figures
VerifiedAdd labels, captions, and text references to every figure in a LaTeX paper
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.2 KB |
SKILL.md
View on GitHub---
description: Add labels, captions, and text references to every figure in a LaTeX paper
model: haiku
---
# 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
````latex
% ```
% 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
````latex
% ```
% 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:
```latex
(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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |