OpenSkillIndex← back to search
claude-code

TapCanvas tapcanvas-collage-local

Use local Python Pillow to compose storyboard/role-card collages with per-cell role-name labels. No model call needed.

install
source · Clone the upstream repo
git clone https://github.com/anymouschina/TapCanvas
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/anymouschina/TapCanvas "$T" && mkdir -p ~/.claude/skills && cp -r "$T/apps/agents-cli/skills/tapcanvas-collage-local" ~/.claude/skills/anymouschina-tapcanvas-tapcanvas-collage-local && rm -rf "$T"
manifest: apps/agents-cli/skills/tapcanvas-collage-local/SKILL.md
source content

TapCanvas Local Collage

Use this skill when the task is:

  • merge multiple storyboard frames into one grid image
  • merge role-card images and add role-name labels
  • avoid model-based collage generation

This skill is local-first and deterministic. It does not call any model API.

Prerequisites

  • Python 3.9+
  • Pillow

Install:

python3 -m pip install --upgrade pillow

Script

Path:

skills/tapcanvas-collage-local/scripts/collage.py

Input modes

You can pass image inputs as:

  • local file paths
  • HTTP/HTTPS URLs

Usage examples

  1. 2x2 collage with role labels:
python3 skills/tapcanvas-collage-local/scripts/collage.py \
  --input ./tmp/shot1.png \
  --input ./tmp/shot2.png \
  --input ./tmp/shot3.png \
  --input ./tmp/shot4.png \
  --label "真宫寺唯" \
  --label "萧夜" \
  --label "真宫寺唯" \
  --label "萧夜" \
  --output ./tmp/role-collage.png \
  --grid 2 \
  --cell-size 640 \
  --divider-width 4 \
  --divider-color "#ffffff"
  1. URL inputs, auto grid:
python3 skills/tapcanvas-collage-local/scripts/collage.py \
  --input "https://example.com/a.png" \
  --input "https://example.com/b.png" \
  --input "https://example.com/c.png" \
  --output ./tmp/storyboard-collage.png \
  --grid auto

Behavior

  • Fills each cell with center-crop + resize (stable visual layout).
  • Draws a semi-transparent dark label strip at cell bottom.
  • Draws per-cell label text in white.
  • If labels are fewer than images, remaining cells are unlabeled.
  • If labels are more than images, extra labels are ignored.

Output

  • Default output format: PNG.
  • Ensure output path parent directories exist (script auto-creates).