Compose App Icon

uv-bundled CLI pair that authors and JSON-Schema-validates Apple Icon Composer .icon packages

Tested · Works

Test report

Verdict
Tested · Works
Score
10.0/10
Tested
Jul 16, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Jul 18, 2026 · 8676040

Ran the bundled 25-test pytest suite for real (25/25 passed), then fed the same icon document through create_icon.py two ways: a naive version ignoring the SKILL.md 'Gotchas' section failed schema validation with the exact two errors the doc warns about (UI-label shadow kind, scale-only position missing translation-in-points); the version following the gotchas succeeded, produced a real .icon package, and validate_icon.py reported it VALID with output formatting matching the docs byte-for-byte.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 10/10
  • Docs & honesty 5/5

What Compose App Icon does

Authors new Apple Icon Composer `.icon` packages from an icon.json + asset files, edits existing packages in place, and validates any `.icon`/icon.json against a bundled JSON Schema, covering fills, blend modes, shadows, translucency, LiquidGlass, and light/dark/tinted specializations. Triggers on requests to generate an app icon, scaffold a `.icon`, change any icon.json field, or diagnose why Icon Composer won't open a package.

How to install Compose App Icon

git clone https://github.com/giginet/apple-icon-composer-skill
mkdir -p ~/.claude/skills
cp -r apple-icon-composer-skill/plugins/icon-composer/skills/compose-app-icon ~/.claude/skills/compose-app-icon

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Compose App Icon

  • /compose-app-icon uv-bundled CLI pair that authors and JSON-Schema-validates Apple Icon Composer .icon packages

It also activates on plain-language prompts like these:

  • Scaffold a new app icon package with a gradient fill and glass layer.
  • Validate why Icon Composer won't open my .icon package file.
  • Add a dark mode specialization to my existing app icon.json.

Frequently asked questions

Is the Compose App Icon skill free?
Yes. The skill itself is free from giginet/apple-icon-composer-skill. SkillProof publishes the install command and an independent test verdict at no cost.
Does Compose App Icon work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 16, 2026. Verdict: Tested · Works. Ran the bundled 25-test pytest suite for real (25/25 passed), then fed the same icon document through create_icon.py two ways: a naive version ignoring the SKILL.md 'Gotchas' section failed schema validation with the exact two errors the doc warns about (UI-label shadow kind, scale-only position missing translation-in-points); the version following the gotchas succeeded, produced a real .icon package, and validate_icon.py reported it VALID with output formatting matching the docs byte-for-byte.
What is the Compose App Icon SkillProof Score?
10.0/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 10/10, docs & honesty 5/5.
How do I install Compose App Icon?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Compose App Icon with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.