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
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/icon-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/icon-design/
1Skills CLI (Vercel)
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a codex2Manually: put the files in place
.agents/skills/icon-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a cursor2Manually: put the files in place
.cursor/skills/icon-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install omer-metin/skills-for-antigravity skills/icon-design2Manually: put the files in place
.github/skills/icon-design/SKILL.md1Skills CLI (Vercel)
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/omer-metin/skills-for-antigravity --path skills/icon-designManually: put the files in place
.devin/skills/icon-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add omer-metin/skills-for-antigravity --skill icon-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.