# Figures Gallery

> Generates an HTML gallery of all project figures with captions and source notebooks. Use when reviewing figures.

- Skill: `brycewang-stanford/figures-gallery` (Agent Skill)
- Install (CLI): `npx skillmds@latest add brycewang-stanford/figures-gallery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brycewang-stanford/figures-gallery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: brycewang-stanford (https://skillmd.com/u/brycewang-stanford)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/brycewang-stanford/figures-gallery

---


# Generate Figures Gallery

Create an HTML gallery page displaying all project figures with their captions and source notebooks.

## Steps

1. Scan `images/` for all image files:
   - Supported formats: `.png`, `.jpg`, `.jpeg`, `.svg`, `.pdf`
   - Record each file's name, path, and modification date

2. Scan all registered notebooks (from `_quarto.yml`) for cells with `fig-` labels:
   - Extract the cell label (e.g., `fig-sample`, `fig-event-study`)
   - Extract the caption from `#| fig-cap:` or `*| fig-cap:` directives
   - Record the source notebook path

3. Generate an HTML gallery page with:
   - A title and generation timestamp
   - For each figure from `images/`:
     - Image thumbnail (or placeholder for PDFs)
     - Filename as caption
     - File size and dimensions (if determinable)
   - For each figure from notebooks:
     - The cell label
     - The caption (from cell directive)
     - The source notebook name
     - The embed shortcode: `{{< embed notebooks/<name>.ipynb#<label> >}}`
   - Simple CSS styling for a grid layout

4. Save the gallery to `_manuscript/figures-gallery.html` (the `_manuscript/` directory is gitignored, so this output won't be committed).

5. Report:
   - File path to the gallery
   - Count of figures from `images/`
   - Count of figure cells from notebooks
   - Command to open: `open _manuscript/figures-gallery.html`

## Error handling

- If `images/` does not exist or is empty, note it and continue with notebook figures.
- If no notebooks have `fig-` labeled cells, note it and continue with `images/` files.
- If both sources are empty, report "No figures found in the project."