icon-design
Skill1 starsChanged 2 months agoMITView on GitHub
Design, refine, inspect, and package macOS or iOS icons using editable SVG, optical size variants, and explicit Apple delivery routes. Use for app identities, document icons, icon families, or icon craft reviews; distinguish these from interface symbols. Includes material illustration, small-size correction, Icon Composer layer preparation, and reproducible raster/ICNS tools.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- ArnavPuri/designskillstheir own version, first seen Nov 1, 2026
- ai4brands-design/claude-skillstheir own version, first seen Mar 22, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- ArnavPuri/designskills★ 17same name
- ai4brands-design/claude-skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository39 other files it gives its agents.
- apple-native-motionSkill
- apple-ui-copySkill
- audit-macos-appSkill
- brain-wikiSkill
- catch-me-upSkill
- checkpointSkill
- claude-md-coachSkill
- claudeSkill
- codexSkill
- crash-debuggingSkill
- cut-memorySkill
- explaining-problemsSkill
- file-batch-safetySkill
- handoffSkill
- heads-downSkill
- hopper-mcpSkill
- interface-integritySkill
- ios-defaultsSkill
- kitSkill
- macos-defaultsSkill
- mock-and-pickSkill
- obsess-heroSkill
- obsessSkill
- offline-archiveSkill
- os-workaroundsSkill
- paper-mcpSkill
- predictionSkill
- second-loopSkill
- session-auditSkill
- ship-macosSkill
- show-meSkill
- slice-and-reviewSkill
- slow-modeSkill
- spatial-interfacesSkill
- standupSkill
- synthetic-fixturesSkill
- transitional-interfacesSkill
- web-design-defaultsSkill
- window-captureSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 5 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Read Concept and judgment.
- Very specific: line 18
Read Review and delivery. Inspect actual renders, alpha, light/dark/busy backgrounds, peers, and target application.
- Distinctive: line 25
Keep authored surface shading distinct from system-owned effects.
- Distinctive: line 27
Treat current Apple masking as a delivery contract.
- Distinctive: line 28
Do not extrapolate 2000s desk perspective, tilt, color-depth tables, or mask conventions into current requirements.
- Distinctive: line 29
Never declare a static browser preview equivalent to Icon Composer or a shipped-device render.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Icon design
Make a recognizable object at its actual viewing size. Preserve the editable design decisions and prove the delivered resource matches them.
Start here
- Identify the role: app identity, document/file type, interface symbol, or customization artwork. Record the app's human purpose, audience, recognizable anchor, platform, minimum OS, current Xcode, appearances, and exact deliverables. Infer routine choices; ask only for missing decisions that affect direction.
- Read Concept and judgment. For premium craft or reference-led work, read Premium reference review. Produce two or three materially different silhouettes when the direction is open. Use SVG roughs; do not perfect three cosmetic variations of one idea.
- For style direction, modernization, or dimensional artwork, read Evolution and future. Separate depth, perspective, tilt, and rendering ownership. Select the delivery route before adding effects. Read Apple delivery: clean layered art for Icon Composer; painted masters for static illustration/asset catalogs; separate symbol conventions for UI. OS-dependent facts are dated and must be refreshed when shipping.
- Build named geometry, then value hierarchy, material, and restrained detail. Read Construction and, for dimensional illustration, Materials and light.
- Review early at intended size. Read Optical sizes and families. Author smaller compositions when scaling loses identity. A 16-point @2x resource and a 32-point @1x resource can need different artwork despite both being 32 pixels.
- Render and inspect using Tooling. Use a new output directory each build. Exporting must never replace an authored optical source. Verify receipts after edits.
- Read Review and delivery. Inspect actual renders, alpha, light/dark/busy backgrounds, peers, and target application. Record source, raster, package, OS-context, and human acceptance separately.
Non-negotiable craft
- One recognizable idea leads. Detail earns its place by improving identity, depth, or material.
- Optical balance wins over numeric symmetry. Metrics identify questions; they do not grade beauty.
- Preserve identity across sizes and appearances; simplify geometry and redistribute contrast.
- Keep authored surface shading distinct from system-owned effects. Avoid double shadows and baked glass in Composer inputs.
- Preview every new rendering technique before scaling up its use. An SVG that parses can still render differently across engines.
- Treat current Apple masking as a delivery contract. Do not bake today's app-icon outer mask into Composer layers.
- Do not extrapolate 2000s desk perspective, tilt, color-depth tables, or mask conventions into current requirements.
- Never declare a static browser preview equivalent to Icon Composer or a shipped-device render.
Progressive disclosure map
| Need | Read |
| Metaphor, style, critiques, avoiding generic polish | Concept and judgment |
| Bézier shapes, layer structure, SVG primitives, masks | Construction |
| Paper, metal, wood, paint, fiber, highlights, shadows | Materials and light |
| Pixel decisions, logical size, appearance consistency | Optical sizes and families |
| Current macOS/iOS integration and version caveats | Apple delivery |
| CLI, inspector, schemas, dependencies, failure recovery | Tooling |
| Concrete acceptance and defect diagnosis | Review and delivery |
| Twenty-year evolution, retained craft, future dimensional styles | Evolution and future |
| Curated examples, material standards, junction audits | Premium reference review |
| Faithful from-scratch course exercise | Course reconstruction |
| What came from the course; what changed | Learning ledger |
| Synthetic assertions and renderer qualification | Fixtures |
Working outputs
Keep a brief, concept sheet, editable masters, explicit resource manifest, render receipt, inspection sheet, and delivery notes. Add .icon or compiled packages only when that route has actually been executed. Start from the original example when a deterministic tool smoke test is useful; do not turn its identity into the user's design by default.
The skill is an original operational synthesis of the locally studied Icon Resource course, associated Iconfactory manuals, and dated Apple documentation. It contains no course videos, transcripts, PSDs, or extracted course artwork. The separately attributed course study is independently redrawn. See the learning ledger for provenance and coverage limits.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

