dvy1987/agent-loom / .agents/skills/.deprecated/icon-craft-deprecated-2026-06-30
icon-craft
VerifiedPick an icon strategy and produce a coherent icon set that doesn't look mass-produced. Solves the "Lucide everywhere" problem — every AI-generated UI uses the same 24px stroke-1.5 outline icons, which is the second-biggest vibecoded tell after Inter-on-purple-gradient. Generates custom SVG sets, tunes existing icon libraries to match archetype + typography, defines stroke weight, optical sizing, and corner-radius rules. Load when the user asks to pick icons, design an icon set, customize Lucide / Phosphor / Heroicons, generate SVG icons, make icons feel custom, says "the icons look generic", "design a custom icon system", "icons for this product", or when frontend-design routes here during icon craft. Sub-skill of frontend-design.
| File | Kind | Size |
|---|---|---|
| DEPRECATION.md | markdown | 796 B |
| SKILL.md | skill md | 7.3 KB |
| references/icon-strategies.md | markdown | 4.3 KB |
| references/svg-craft.md | markdown | 3.6 KB |
references/icon-strategies.md
View on GitHub# Icon Strategies
The five viable strategies and when to use each.
## 1. tuned-phosphor (or tuned-existing)
**What:** Pick Phosphor (or another high-quality icon family) at ONE weight, normalize stroke + size to match the typography, hand-adjust outliers.
**Use when:**
- b2b-productivity, enterprise-trust, dev-tool
- Time/budget for bespoke is limited
- The product needs 20+ icons (custom-svg cost grows linearly)
**Phosphor weights map:**
| Weight | Pair with |
|---|---|
| Thin (1px stroke) | Light or thin display type |
| Light (1.25px) | Regular grotesque body |
| Regular (1.5px) | Default for most archetypes |
| Bold (2px) | Bold display, playful archetypes |
| Fill (solid) | Playful-consumer, marketing accent moments |
| Duotone | Specific archetypes only — easy to overuse |
**Banned:** Default Lucide drop-in (stroke 2px, default 24px size, default corner radius). Acceptable only if every icon is hand-tuned.
## 2. custom-svg
**What:** Draw a bespoke icon set on a defined grid with documented stroke, radius, terminal style.
**Use when:**
- premium-consumer (almost always)
- The product has 8–20 signature icons that recur frequently
- Brand identity demands a unique visual mark
**Cost:** Roughly 1 hour per simple icon, more for complex. Set of 12 = a half-day commitment.
**Worth it because:** Custom icons are the single fastest way to make a UI not look AI-generated.
## 3. hand-drawn
**What:** Hand-drawn (or hand-drawn-feeling) marks — sketchy strokes, slight imperfection, often imported from real ink.
**Use when:**
- editorial — when icons are needed at all
- Specific brand identities (illustration-led products)
- Marketing moments where icons need warmth
**Caution:** Reads as twee or unprofessional in B2B contexts. Don't use for nav/action icons in productivity tools.
## 4. mixed-metaphor
**What:** System glyphs (✶ ✻ → ↗ ● ◆), ASCII marks, emoji where defensible, simple shapes used as decoration. NOT a drawn icon set.
**Use when:**
- brutalist-distinctive
- Markdown-native interfaces
- When the product wants to refuse the "icon language" entirely
**Examples:** Posthog uses ASCII art. Are.na uses geometric glyphs. Old-school terminals use unicode block elements.
## 5. system-native
**What:** SF Symbols (Apple), Material Symbols (Google), Fluent (Microsoft).
**Use when:**
- The product targets ONE platform exclusively (iOS-only, Material-Web-only)
- Brand IS the platform (Apple ecosystem feel)
**Caution:** Cross-platform products using SF Symbols on the web look "Apple-derivative" in a bad way unless the rest of the design is committed to that lineage.
---
## Decision matrix by archetype
| Archetype | Default | When to escalate to custom-svg |
|---|---|---|
| b2b-productivity | tuned-phosphor light | Brand wants strong signature mark |
| enterprise-trust | tuned-phosphor regular | Rare — usually unnecessary |
| premium-consumer | **custom-svg** | Always |
| playful-consumer | custom-svg with personality OR Phosphor Bold/Fill | If brand is character-led |
| editorial | hand-drawn or none | If the editorial voice demands signature marks |
| brutalist-distinctive | mixed-metaphor / system glyphs | Rare — drawn icons soften the position |
| dev-tool | tuned-phosphor light | If brand has a strong terminal-glyph identity |
| marketing-landing | inherits product | When marketing has bespoke moments product doesn't |
| creative-tool | custom-svg or tuned-phosphor regular | When brand has a strong studio identity (Runway, Leonardo) |
| social-feed | custom-svg (action rail icons MUST be hand-tuned) | Always — these are the most-seen icons in the product |
| conversational-ai | custom-svg or tuned-phosphor light/regular | When the small icon set (10–20) deserves bespoke quality |
| spatial-canvas | custom-svg with mild character + mixed-metaphor for shapes/connectors | Always — toolbar icons drive the entire interaction |
---
## When to refuse to add icons
Some "we need icons here" instincts are wrong:
- Headings rarely need icons (kills hierarchy)
- Body text never needs icons (clutters reading)
- Features in marketing pages often work better with type + screenshot than with icon + h3 + paragraph
- Empty states often work better with type + a single character glyph than with an illustration
Push back on icon proliferation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |