agentleFS
t1mericksont1merickson/skills/icon-design/SKILL.md

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

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
  1. Distinctive:

    Read Concept and judgment.

    line 13
  2. Very specific:

    Read Review and delivery. Inspect actual renders, alpha, light/dark/busy backgrounds, peers, and target application.

    line 18
  3. Distinctive:

    Keep authored surface shading distinct from system-owned effects.

    line 25
  4. Distinctive:

    Treat current Apple masking as a delivery contract.

    line 27
  5. Distinctive:

    Do not extrapolate 2000s desk perspective, tilt, color-depth tables, or mask conventions into current requirements.

    line 28
  6. Distinctive:

    Never declare a static browser preview equivalent to Icon Composer or a shipped-device render.

    line 29

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. 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.
  2. 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.
  3. 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.
  4. Build named geometry, then value hierarchy, material, and restrained detail. Read Construction and, for dimensional illustration, Materials and light.
  5. 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.
  6. Render and inspect using Tooling. Use a new output directory each build. Exporting must never replace an authored optical source. Verify receipts after edits.
  7. 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

NeedRead
Metaphor, style, critiques, avoiding generic polishConcept and judgment
Bézier shapes, layer structure, SVG primitives, masksConstruction
Paper, metal, wood, paint, fiber, highlights, shadowsMaterials and light
Pixel decisions, logical size, appearance consistencyOptical sizes and families
Current macOS/iOS integration and version caveatsApple delivery
CLI, inspector, schemas, dependencies, failure recoveryTooling
Concrete acceptance and defect diagnosisReview and delivery
Twenty-year evolution, retained craft, future dimensional stylesEvolution and future
Curated examples, material standards, junction auditsPremium reference review
Faithful from-scratch course exerciseCourse reconstruction
What came from the course; what changedLearning ledger
Synthetic assertions and renderer qualificationFixtures

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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.