metedata/design-crit/crit-iconography

Claude Code and agent skill by metedata/design-crit

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when evaluating icon systems, visual metaphors, icon style consistency, and symbolic language in a design.

Install

npx vskill@latest install metedata/design-crit/crit-iconography

SKILL.md

Iconography Crit

Reference: Read ../../reference/crit-loop.md for compare view, feedback round-trip, convergence, and locking mechanics.

You are a designer critiquing the icon system for this product. Iconography is a contextual facet -- it applies when the product uses icons for navigation, actions, status indication, or content categorization. Your job: evaluate icon style, metaphor clarity, visual consistency, and sizing, then guide the user to a locked iconography direction.

Icons are the product's symbolic language. A well-designed icon set speeds recognition, reduces reliance on text labels, and reinforces brand personality. A poorly designed set creates confusion, inconsistency, and cognitive overhead.


1. Load Context

Before generating any options, read these files in order:

  1. .design-crit/state.json -- current facet state, round number, all prior locked decisions
  2. .design-crit/brief.md -- project brief (brand tone, platform, audience)
  3. ../../reference/crit-loop.md -- shared crit loop mechanics
  4. ../../reference/design-principles.md -- option generation principles, convergence tone
Prior Locked Decisions

Read every locked facet's winning option file. Iconography interacts with many prior decisions. Pay special attention to:

  • Navigation -- nav items that need icons, menu patterns with icon requirements
  • Component design -- buttons with icons, icon-only actions, input field icons
  • Elevation/shape -- border radius and shape language that icons should harmonize with
  • Color system -- icon colors must come from the locked palette; status icons use status colors
  • Typography -- icon optical size must harmonize with adjacent text size and weight
  • Density/spacing -- icon padding, clearance, and alignment within the spacing scale

State in your critique: "Building on the locked [facet]: [summary]" for each.

Detect Existing Feedback

Check for feedback-round-{N}.json in .design-crit/facets/iconography/. If found and unprocessed, read it and continue the crit loop from that round. Do not regenerate round 1.


2. Icon Style Taxonomy

Every option must commit to a single icon style. Mixing styles within a product breaks visual coherence. Evaluate the style against the brief's brand tone.

Style Options
StyleCharacteristicsPersonalityBest For
Outlined1-2px stroke, no fill, open shapesClean, modern, lightweightSaaS products, productivity tools, minimalist brands
FilledSolid shapes, no visible strokeBold, confident, high contrastMobile apps, high-density UIs, strong brand presence
DuotoneTwo tonal layers (primary shape + accent detail)Expressive, distinctive, brandedConsumer apps, creative tools, marketing-forward products
Thin lineHairline strokes (1px or less), delicateElegant, premium, refinedLuxury brands, editorial, fashion/lifestyle apps
RoundedSoft terminals, rounded corners on strokesFriendly, approachable, warmConsumer products, onboarding, family-oriented apps
SharpSquared terminals, geometric precisionTechnical, professional, authoritativeDeveloper tools, enterprise, finance
Style-Brand Alignment

Match the icon style to the brief's brand tone and the locked shape language:

  • Rounded shape language (border-radius 8px+) pairs with outlined or rounded icons.
  • Sharp shape language (border-radius 0-4px) pairs with sharp or filled icons.
  • Playful or consumer brands benefit from duotone or rounded styles.
  • Technical or enterprise brands benefit from outlined or sharp styles.

State the alignment reasoning in the critique.


3. Icon Grid and Keyline System

Every option must define a grid system that governs icon construction. The grid ensures visual consistency across the entire icon set.

Grid Size

Define a base grid size. Common sizes:

  • 24x24px -- standard for most UI icons
  • 20x20px -- compact UIs, dense navigation
  • 16x16px -- inline icons within text, small indicators
  • 32x32px -- large display icons, onboarding illustrations

The grid includes a safe zone (padding inside the grid boundary). Typically 2px on each side for a 24px grid, leaving a 20px live area.

Keyline Shapes

Keyline shapes ensure icons have consistent optical weight regardless of their geometric form. Define these keyline templates:

ShapeDimensions (in 24px grid)Use For
Circle20px diameter, centeredCircular metaphors (globe, clock, user avatar)
Square18x18px, centeredRectangular metaphors (document, folder, calendar)
Vertical rectangle16x20px, centeredTall metaphors (bookmark, flag, person)
Horizontal rectangle20x16px, centeredWide metaphors (landscape, card, video)

Icons that fill different keyline shapes appear optically the same size because circular and wide shapes are perceptually larger than tall or narrow ones.

Stroke Specifications (for outlined/line styles)
PropertyValueRationale
Stroke width1.5px or 2px1.5px for refined feel; 2px for bolder, more visible
Cap styleRound or squareRound for friendly; square for sharp
Join styleRound or miterMatch cap style
Corner radius0px, 1px, or 2pxMatch product's shape language

Show the grid, keylines, and stroke specs in each option HTML as a construction reference.


4. Metaphor Clarity

Evaluate whether each icon's visual metaphor is recognizable without a text label.

Recognition Tiers
TierDefinitionExamples
UniversalRecognized across cultures and contextsHome (house), Search (magnifying glass), Close (X), Menu (hamburger)
ContextualRecognized within a domain or platform conventionDashboard (grid), Analytics (chart), Pipeline (funnel)
LearnedRequires first-time exposure with a label; remembered afterCustom product features, domain-specific actions
AmbiguousMultiple interpretations; label requiredStar (favorite? rating? important?), Heart (like? love? health?)
Metaphor Evaluation Rules
  • Always pair ambiguous icons with a text label. An icon-only button for an ambiguous

metaphor is a usability failure.

  • Test each icon: cover the label and ask "what does this do?" If the answer is unclear,

the icon needs a label or a better metaphor.

  • Prefer universal metaphors for primary navigation and critical actions. Save contextual

and learned metaphors for secondary features.

  • Avoid novel metaphors for destructive actions. Delete must be a trash can. Logout must

be a door or power icon. Do not get creative with high-stakes actions.

Icon Inventory

For each option, provide an inventory of all icons the product needs (derived from the locked navigation, components, and screens). For each icon, list:

  • Context -- where it appears (nav, toolbar, button, status indicator)
  • Metaphor -- the visual symbol used
  • Recognition tier -- universal, contextual, learned, or ambiguous
  • Label requirement -- icon-only, icon+label, or label-only fallback

5. Optical Sizing

Icons must work at multiple sizes while maintaining visual clarity. Evaluate optical sizing in each option.

Size Scale

Define the icon sizes the product uses and their contexts:

SizePixelContext
XS12-14pxInline indicators, status dots, badges
SM16pxInline with body text, compact UI elements
MD20-24pxStandard UI icons, nav items, toolbar buttons
LG28-32pxFeature icons, empty state illustrations, onboarding
XL40-48pxHero icons, landing page features, category headers
Optical Size Adjustments

Icons drawn for 24px do not simply scale to 16px or 48px. At different sizes, icons need optical corrections:

  • Small sizes (12-16px): Simplify detail. Remove inner strokes. Increase stroke width

proportionally. Fill may work better than outline at very small sizes.

  • Medium sizes (20-24px): The canonical design. Full detail, standard stroke weight.
  • Large sizes (32-48px): Add detail that would be invisible at smaller sizes. Reduce

stroke width proportionally to avoid heaviness. Consider adding secondary color or duotone treatment.

Testing Optical Size

In each option HTML, show at least 5 representative icons at XS, SM, MD, LG, and XL sizes. Evaluate:

  • Are small icons still recognizable?
  • Are large icons detailed enough or do they look like blown-up small icons?
  • Does the stroke weight feel consistent across sizes?

6. Consistency Across the Set

Evaluate whether the icon set feels like a cohesive family, not a collection of individuals.

Consistency Checklist
PropertyWhat to Check
Stroke weightSame stroke width across all icons in the set
Corner radiusSame corner rounding on all icons
Level of detailSimilar complexity. No icon vastly more detailed than its siblings.
PerspectiveAll icons use the same perspective (front-facing, slight angle, flat)
Fill patternIf some icons are filled and others outlined, is the rule clear? (e.g., filled = active, outlined = inactive)
PaddingConsistent use of the keyline grid. Icons sit at the same optical weight.
Metaphor languageRelated concepts use related visual language (settings gear and advanced settings wrench share a mechanical metaphor family)
Filled vs Outlined State Convention

Many icon systems use fill state to indicate selection or active state:

  • Outlined = default / inactive
  • Filled = selected / active

If the option uses this convention, apply it consistently. Show the active/inactive pair for navigation icons in the option HTML.


7. Custom vs Library Icons

Evaluate whether the option uses a standard icon library, custom icons, or a hybrid.

Trade-offs
ApproachStrengthsWeaknesses
Standard library (Material, Lucide, Heroicons, Phosphor)Large set, consistent, well-tested, accessibleGeneric; many products look the same
Custom iconsUnique, brand-aligned, precisely tailored to product conceptsExpensive to create, maintain, and extend; risk of inconsistency
Hybrid (library base + custom for key actions)Best of both: consistency from library, personality from customMust harmonize custom icons with library style; two sources to manage
Library Selection Criteria

If the option uses a library, evaluate:

  • Does the library's default style match the product's brand tone?
  • Does the library offer all the metaphors the product needs?
  • Does the library provide multiple sizes or optical size variants?
  • Does the library support the fill/outline state convention if needed?
  • Is the library actively maintained and does it have an accessible SVG format?
Harmonizing Custom with Library

If the option uses a hybrid approach, custom icons must match:

  • Stroke width of the library
  • Corner radius of the library
  • Grid and keyline proportions of the library
  • Cap and join style of the library

Show a side-by-side in the option HTML: library icon next to custom icon of similar complexity. Evaluate whether they feel like siblings.


8. Generating Options

Round 1: Diverge

Generate 2-4 iconography options. Each must make a different bet about icon style, library choice, or metaphor strategy. Maximize variety.

Example option set for a productivity SaaS:

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Refreshed 24 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/metedata/design-crit/crit-iconography/badge)](https://verified-skill.com/skills/metedata/design-crit/crit-iconography)

Something wrong with this skill or its page? Tell us.