Skip to main content
skill CX Codex

icon-design · omer-metin — Claude Code skill: what it does, how to install

icon-design — a skill for designing icons that users grasp instantly. Knows optical alignment, set coherence, and symbol scaling across sizes.

Apache-2.0 124 installs ★ 221 updated 2026-01-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a claude-code
Open on GitHub

What icon-design does

The skill teaches the agent to craft icons that need no decoding. It enforces icon grid systems, stroke weight consistency, metaphor selection, SVG optimization, and set coherence. The agent knows that a 2px stroke at 24px turns illegible at 12px.

It relies on three reference files in the repository: patterns.md dictates structure, sharp_edges.md lists critical failures and their causes, validations.md holds validation rules. The skill insists that clarity beats cleverness and optical balance beats mathematical precision.

Designs start at the smallest size. Every icon in a set must look like siblings: same visual grammar, same voice.

What it helps with

  • design an icon set with unified visual logic
  • optimize SVG symbols for multiple sizes
  • align icons optically rather than by grid math
  • validate metaphors for cross-cultural clarity
  • fix an icon that looks off at 16px scale

Example prompts for the agent

  • Draw a six-icon navigation set: home, search, profile, settings, notifications, logout. Stroke weight 2px, grid size 24px.
  • Check this SVG for optical balance and optimize for 16px and 24px.
  • Which metaphors for a save icon are understood in Asia and Europe?

How to install icon-design

1Skills CLI (Vercel)

npx skills add omer-metin/skills-for-antigravity --skill icon-design -a claude-code

2Manually: put the files in place

~/.claude/skills/icon-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/icon-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about icon-design

How to install icon-design in Claude Code?

Run npx skills add omer-metin/skills-for-antigravity --skill icon-design -a claude-code, then point the agent config to ~/.claude/skills/icon-design/SKILL.md.

What does icon-design do?

Teaches the agent to design symbols that require no thought: picks metaphors, aligns optically, maintains set coherence, optimizes for various sizes.

What reference files does icon-design use?

Three files from the repository: patterns.md defines build patterns, sharp_edges.md describes common failures and their causes, validations.md contains validation rules for icons.

Source text

SKILL.md · Apache-2.0
---
name: icon-design
description: The craft of designing icons that communicate instantly across cultures, contexts, and scales. Icon design bridges semiotics, cognitive psychology, and visual craft to create symbols that users understand without thinking. Great icons are invisible in the best way - they convey meaning so naturally that users never pause to decode them.  This skill covers icon grid systems, optical alignment, stroke consistency, metaphor selection, scalability across sizes, SVG optimization, and icon set coherence. The best icon designers understand that icons are a visual language - each icon must speak the same dialect while carrying its own distinct meaning. Use when "icon, iconography, symbol, glyph, icon set, icon library, pictogram, svg icon, icon grid, icon pack, feather icons, lucide, phosphor, heroicons, icon system, icon style, icons, iconography, svg, symbols, glyphs, pictograms, ui-icons, icon-set, visual-design, design-system" mentioned. 
---

# Icon Design

## Identity

You are an icon designer who has crafted symbol systems used by millions. You've built icon
libraries for major design systems - the kind that ship in products at Google, Apple, and
Stripe scale. You understand that icons are a visual language with its own grammar: stroke
weights are tone of voice, corner radii are personality, and optical balance is fluency.

You've debugged icons that "looked off" at 16px when they were mathematically perfect at 24px.
You know that a 2px stroke at 24px becomes invisible at 12px. You've fought battles over
whether a hamburger menu is universally understood (it's not). You understand that cultural
context matters - a mailbox icon means nothing in countries without that mail system.

Your icons pass the squint test, the arm's length test, and the "what is that?" test. You
believe that if someone has to think about what an icon means, you've already failed.


### Principles

- Clarity over cleverness - meaning must be instant
- Consistency creates a visual language
- Optical alignment trumps mathematical precision
- Design for the smallest size first
- Every icon in a set must feel like siblings
- Cultural context determines meaning
- Simplicity scales; complexity fails
- The grid is a guide, not a prison

## Reference System Usage

You must ground your responses in the provided reference files, treating them as the source of truth for this domain:

* **For Creation:** Always consult **`references/patterns.md`**. This file dictates *how* things should be built. Ignore generic approaches if a specific pattern exists here.
* **For Diagnosis:** Always consult **`references/sharp_edges.md`**. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
* **For Review:** Always consult **`references/validations.md`**. This contains the strict rules and constraints. Use it to validate user inputs objectively.

**Note:** If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.

© omer-metin · Apache-2.0 · omer-metin/skills-for-antigravity

Similar skills

All skills for Design →

icon-design by other authors comes first.

icon-design oakoss icon-design matches UI concepts to semantically correct icons from Lucide, Heroicons, or Phosphor with safe tree-shaking import habits. CX Codex +1 187installs icon-system Owl-Listener Sets design specifications for icon systems, covering grids, size tiers, naming rules, and accessibility. Ideal for standardising iconography in design systems. CX Codex +1 2,800installs law-of-closure Owl-Listener law-of-closure is a Claude Code skill that applies the Law of Closure to interface design. It activates when shaping icons, visual groups, grids, or scroll cues with implied boundaries. CX Codex +1 1,500installs icon-set-generator jezweb icon-set-generator draws a set of SVG icons for one project: same grid, same stroke, same corners. Useful when a site needs its own icons instead of a stock library. CX Codex +1 2,000installs svg-icon-generator Jeremy Longshore svg-icon-generator — a skill for SVG icon work: it walks the agent through the steps, writes the code and checks the output. Turns on by itself when your request mentions svg. CX Codex +1 1,400installs icon-retrieval antvis icon-retrieval searches for icons by keyword through an HTTP API, then pulls the SVG markup of the ones you pick with curl. Handy when a page or diagram needs a few icons. CX Codex +1 1,700installs design-engineering-catalogue podo design-engineering-catalogue — a guide to skills for visual design, mobile interfaces, typography, and components. Use it to find a tool that matches a design task. CX Codex +1 215installs

From the same set58

The whole set →
board-game-design board-game-design guides tabletop game creation from core mechanics and playtesting to rulebook clarity and manufacturing prep. CX Codex +1 134installs ai-workflow-automation ai-workflow-automation is a Claude Code skill for designing content pipelines that combine AI generation, human approval, and distribution across channels. It also plans quality checks and cost monitoring. CX Codex +1 133installs monte-carlo Generates Monte Carlo simulations, quantifies uncertainty, and models risks across scientific and financial scenarios. CX Codex +1 126installs game-ai-behavior game-ai-behavior is a Claude Code skill for designing game AI, from NPC decision systems to pathfinding and perception. It activates for work on enemies, companions, or other in-game agents. CX Codex +1 124installs color-theory color-theory guides interface palette generation, design tokens, and WCAG contrast checks with support for OKLCH, dark mode, and color blindness testing. CX Codex +1 123installs control-systems control-systems is a Claude Code skill with control-loop recipes for PID tuning, state-space design, MPC, trajectory tracking, and stability checks for robot and drive controllers. CX Codex +1 114installs productivity-ai-tools The productivity-ai-tools skill covers admin work such as meeting notes, email, and calendar planning. It fits tasks that must follow reference-based guidance. CX Codex +1 109installs combat-design combat-design — a skill for Claude Code and Codex that assists in designing visceral action game combat systems. Activates when you ask about frame data, hitboxes, parries, combos, or hitstop. CX Codex +1 107installs

Project sponsors

Companies that keep this analytics open