Skip to content

Add polaroid + mosaic collage skills#7

Merged
kvz merged 3 commits into
mainfrom
kvz/collage-skills
Apr 18, 2026
Merged

Add polaroid + mosaic collage skills#7
kvz merged 3 commits into
mainfrom
kvz/collage-skills

Conversation

@kvz
Copy link
Copy Markdown
Member

@kvz kvz commented Apr 16, 2026

Summary

Companion to transloadit/api2#7651 and transloadit/node-sdk#393, which add a `/image/merge` `effect` parameter (`polaroid-stack`, `mosaic`) and an `image merge` CLI intent respectively.

Two new transform-* skills that wrap the `image merge` intent:

  • `transform-build-polaroid-collage-with-transloadit` — overlapping instant-photo style on a colored canvas, with shadow and random tilt
  • `transform-build-mosaic-collage-with-transloadit` — justified tile layout that respects each photo's aspect ratio

Each skill follows the existing `transform-*` pattern (`SKILL.md` only, clear input/output contract, runnable `npx -y @transloadit/node` command, tuning tips, debug section).

Drafted — should not merge until api2#7651 and node-sdk#393 ship, since both skills depend on the `image merge` CLI intent being publicly available.

Test plan

  • `yarn check` passes (TypeScript + biome lint)
  • After node-sdk#393 releases: run each skill's example `npx -y @transloadit/node image merge ...` command with real inputs and confirm the output file exists

🤖 Generated with Claude Code

Two new transform-* skills that wrap the `image merge` CLI intent
from @transloadit/node with the `/image/merge` Robot's new
polaroid-stack and mosaic effects. Each skill has a clear input/
output contract, a runnable command, tuning tips, and debug notes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@kvz kvz marked this pull request as ready for review April 17, 2026 18:50
@kvz kvz self-assigned this Apr 17, 2026
kvz and others added 2 commits April 17, 2026 23:01
Mirrors the `generate-image` → `transform-generate-image-with-transloadit`
pattern. Agents and humans reaching for "create a polaroid collage"
or "create a mosaic collage" as their first guess land on a one-line
discovery skill that routes them to the full workflow.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Anthropic's SKILL.md spec doesn't support an `aliases` frontmatter
field, but the documented `when_to_use` field is explicitly designed
for "trigger phrases or example requests" that help Claude decide when
to invoke a skill. It gets appended to `description` in the listing
(sharing the 1,536-char cap) — same discoverability benefit as a
separate short-named alias skill, with zero duplication.

- Delete the three alias skills: generate-image,
  create-polaroid-collage, create-mosaic-collage.
- Add rich when_to_use blocks to the three skills they pointed at,
  folding in the trigger phrases and disambiguation advice they
  previously carried, plus cross-references so Claude picks between
  neighbouring skills correctly.
- Update README Examples list to drop the alias and surface both new
  collage skills.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@kvz kvz merged commit a3a57b7 into main Apr 18, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant