feat: wire claude-illustrate-skill into the team - #17
Merged
Conversation
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
marked this pull request as ready for review
July 28, 2026 19:41
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
/illustrategit cloneinstall line (see divergence note below)profiles/iris.mdpointing 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 providedagents/iris.md, hand-syncedcommands/iris.md, DEVLOG entryOne deliberate divergence
The other six companions install with
curl -o ~/.claude/skills/<name>/SKILL.md. This skill is multi-file —backends/andreference/siblings thatSKILL.mdreads on demand — so curl would silently install a skill missing most of its content. It usesgit cloneinstead, 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:
.svgwith--window-sizecrops 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.'<img src="...">'inside afile://contact sheet races the screenshot and fails silently, yielding a blank sheet that reads as a design failure.--virtual-time-budgetis 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
PATHwhile present under the Playwright directory. All now documented as technique.Verification
bash tests/run.sh— 128/128, both drift guards greenraw.githubusercontent.comNote for the maintainer
The repo description on
claude-illustrate-skillis 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