Skip to content

feat: wire claude-illustrate-skill into the team - #17

Merged
d6veteran merged 1 commit into
mainfrom
claude/image-generation-proposals-jx8yav
Jul 28, 2026
Merged

feat: wire claude-illustrate-skill into the team#17
d6veteran merged 1 commit into
mainfrom
claude/image-generation-proposals-jx8yav

Conversation

@d6veteran

Copy link
Copy Markdown
Collaborator

Closes Proposal 6, which absorbed Proposal 4's backend wiring in PR #16.

The skill now exists at code-katz/claude-illustrate-skill (MIT) and carries the mechanics deliberately kept out of this repo: the render-and-inspect pipeline, the contact-sheet technique, per-backend setup for Recraft / Hugging Face / Canva / Figma, the provenance format, and the IP and trademark reference.

The finding worth repeating

Logos and icons need no image backend at all. Vector marks are authored as SVG, rendered across the size ladder, inspected, and refined — no account, no API key, no vendor, no cost. That answers most of the original "Kai cannot create quality images" problem without buying anything. A backend is only needed for raster illustration, a far narrower gap than the problem statement assumed.

What changes here

  • Seventh "Works Well With" row for /illustrate
  • A git clone install line (see divergence note below)
  • One line in profiles/iris.md pointing at the skill, with instructions to say when it is relying on it and work without it if absent — the same rule the Kai fix established, so the persona never claims a capability the install has not provided
  • Regenerated agents/iris.md, hand-synced commands/iris.md, DEVLOG entry

One deliberate divergence

The other six companions install with curl -o ~/.claude/skills/<name>/SKILL.md. This skill is multi-filebackends/ and reference/ siblings that SKILL.md reads on demand — so curl would silently install a skill missing most of its content. It uses git clone instead, called out explicitly in the README rather than left to surprise someone.

Dogfooding caught three real bugs in the skill

Worth noting because each produced plausible-looking wrong output rather than an error:

  • Screenshotting a bare .svg with --window-size crops instead of scaling, so a "16px render" is really the top-left 16×16 corner of a 512px image. Looks like a broken mark; is a broken command.
  • '&lt;img src="..."&gt;' inside a file:// contact sheet races the screenshot and fails silently, yielding a blank sheet that reads as a design failure.
  • --virtual-time-budget is required or capture fires before layout settles.

Plus: individual small PNGs are unreadable viewed alone, so the contact sheet is the primary inspection artifact, not a nicety. And Chromium is frequently absent from PATH while present under the Playwright directory. All now documented as technique.

Verification

  • bash tests/run.sh — 128/128, both drift guards green
  • All skill files return 200 from raw.githubusercontent.com
  • Prior-art licenses verified: all three MIT. Content is original; ideas are credited.

Note for the maintainer

The repo description on claude-illustrate-skill is not set — this session's GitHub app can't create or edit repo metadata (403 on both). Suggested text is in the PR thread.


Generated by Claude Code

Closes Proposal 6, which absorbed Proposal 4's backend wiring. The skill
ships at github.com/code-katz/claude-illustrate-skill and carries the
mechanics that were deliberately kept out of this repo: the
render-and-inspect pipeline, the contact-sheet technique, per-backend
setup for Recraft, Hugging Face, Canva, and Figma, the provenance format,
and the IP and trademark reference.

Its central finding is that logos and icons need no image backend at all.
Vector marks are authored as SVG, rendered across the size ladder,
inspected, and refined, with no account or API key. That answers most of
the original "Kai cannot create quality images" problem without a vendor.

Adds the seventh Works Well With row, a git clone install line, and one
line in Iris pointing at the skill. Iris is told to say when it is relying
on it and to work without it if absent, so the persona never claims a
capability the install has not provided.

The clone install is an explicit divergence from the curl convention the
other six companions use: this skill is multi-file, and curl would
silently install SKILL.md without the backend guides it references.

Tests 128/128.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QTC8r2xtQrke5zzXYLmhfM
@d6veteran
d6veteran marked this pull request as ready for review July 28, 2026 19:41
@d6veteran
d6veteran merged commit 637835a into main Jul 28, 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.

2 participants