AGENT SKILL

icon-design

Designs coherent UI icon families and original application icons, from concept and vector geometry to semantic registries, optical sizes, accessible controls and platform exports. Use when creating, extending, reconstructing or auditing icons, a pictogram set, an app icon, a Dock icon or Icon Composer artwork.

License 许可
MIT
最近更新
2026-11-10
Stars
★ 2
Forks
0

01 前言 Front Matter

name
icon-design
license
MIT
metadata
{ "agent-attribution": "computer=NMG-MBP-M5.local; tool=Codex; version=codex-cli 0.160.0; timestamp=2026-10-27 11:36:23 UTC", "version-timestamp": "2026-10-27 11:36:23 UTC" }
description
Designs coherent UI icon families and original application icons, from concept and vector geometry to semantic registries, optical sizes, accessible controls and platform exports. Use when creating, extending, reconstructing or auditing icons, a pictogram set, an app icon, a Dock icon or Icon Composer artwork.

02 资源文件 1

03 SKILL.md 正文

Icon design

An icon family shares a visual grammar and makes actions easier to recognize. An application icon communicates one product idea at a glance, including at its smallest rendered size.

Defaults

Decision Starting point Change when
Authority Accepted project DESIGN.md, tokens and icon registry A requested reconstruction keeps measured reference geometry in a separate candidate
UI canvas 24x24 viewBox, 2-unit nominal stroke, 2-unit safe inset Extend the existing family's grid and stroke first
Optical sizes Review 16, 20, 24 and 32 CSS px or native pt Deliver only actual product sizes; draw a small variant when detail collapses
Geometry Consistent caps, joins, corner family and apparent weight A recognizable object needs an intentional documented exception
Family selection One licensed system or one original family Mix only with a measured visual correction and named replacement plan
Naming Semantic registry keys such as addItem, archive, syncError Preserve published keys; deprecate instead of silently renaming
Color Semantic foreground token, usually one color State meaning adds text or shape; never color alone
UI state Rest, hover, pressed, selected, focused, disabled, busy where applicable Platform components own states they already implement
Icon-only action Native Button or semantic HTML button with an accessible action name Decorative icons are hidden from accessibility APIs
Web target 24x24 CSS px minimum hit region; 44x44 preferred for touch Larger audience or device requirements override
App icon Three different object/silhouette concepts, one clear idea each A locked accepted concept needs refinement rather than new concepts
App source Editable vector or layered platform source plus export receipt Existing licensed bitmap masters can remain authoritative
Iteration Change one cause per round; inspect at actual sizes A concept failure warrants a new silhouette rather than detail polishing

Workflow

  1. Identify the job. UI glyph family, custom illustration pictograms, application icon, or all three. Record target platforms, sizes, appearances, current assets and allowed change.
  2. Read the project authority. Inspect its icon registry, tokens, approved marks and licensing. Reuse accepted geometry before proposing another family.
  3. Inventory meaning. List each semantic key, action or concept, visible label, context, directional behavior, and required state variants. Separate the same drawing used for different meanings.
  4. Set the grammar. Specify canvas, live area, stroke, caps, joins, corner rules, optical correction, fill policy and baseline. Follow UI and app icons.
  5. Explore the hard cases first. Draw one simple, one dense and one asymmetric glyph; for app icons compare three silhouettes at 16, 32 and 128 units before adding materials.
  6. Build editable assets. Use named vector geometry and a semantic registry. Views request a semantic key, never a vendor symbol name scattered through the app.
  7. Design the optical variants. Simplify interior gaps, open counters and adjust apparent weight at 16. Treat 24-to-16 scaling as a candidate that must survive inspection.
  8. Implement real controls. Keep hit area separate from artwork bounds. Add accessible labels, tooltip and keyboard route when relevant, and selected/busy semantics on the owning control.
  9. Render a contact sheet. Show the whole family on light, dark, selected, high-contrast and content-backed surfaces, at actual target sizes and at enlarged geometry scale.
  10. Inspect in context. Place the icons in representative toolbar, navigation, table and error states. Compare weight beside text and alignment against neighboring controls.
  11. Export for the target. Keep SVG source for web; use licensed platform assets or original native shapes for native UI. App icons follow the actual platform pipeline.
  12. Verify the delivery. Record source hash, export dimensions, registry coverage, appearance matrix, visual findings and runtime checks. A contact sheet alone does not prove keyboard or screen-reader behavior.

Decisions that change the answer

  • Reference reconstruction: measure the source family's geometry and complete observed states first. Preserve exact observed behavior; list intentional adaptations separately when requested.
  • Brand: the approved project system overrides kit geometry and material defaults. An app icon may carry brand character more strongly than utility glyphs.
  • Native platform: use the platform's symbols inside apps when suitable and permitted. Do not assume platform-symbol licenses allow logos, merchandise or application icons.
  • Density: dense desktop tools may use 16pt artwork inside native controls; touch interfaces need larger hit regions without automatically enlarging the glyph.
  • Writing direction: mirror direction-dependent actions such as forward/back where the platform does; preserve symbols whose meaning is fixed, and test the actual RTL layout.
  • Complexity: a small icon cannot explain a detailed workflow. Pair unfamiliar symbols with visible text instead of inventing more detail.
  • macOS Icon Composer: a compiled layered icon requires available actool and Icon Composer's ictool. Source drawings and flat previews remain useful when those tools are missing; compilation and native appearance acceptance remain pending.

Common failures

  • A mixed 1.5-unit and 2-unit stroke family: normalize apparent weight, then inspect circles, diagonals and dense forms together.
  • A glyph looks centered numerically but leans visually: apply a documented optical offset and compare at actual size.
  • A shape with a click handler replaces a button: restore the native control and style its contents.
  • Tooltip is the only accessible name: provide an action label on the control, then add the tooltip as supplementary help.
  • A static icon implies selected or busy without state semantics: bind the owning control's state and test its announcement.
  • An app icon is a miniature screen or wordmark: reduce to one original silhouette and test it at 16.
  • A vendor symbol is repurposed into an application icon without checking its license: replace it with an original design or a permitted asset.
  • The export looks correct only when enlarged: fix the smallest optical variant before adding detail.

References

Catalog IDs covered: icon-design, ui, identity, production

04 同仓库更多 Skills

newmindsgroup
newmindsgroup/visual-design-kit

web-design

Load before planning, designing, auditing or launching any website, landing page, cinematic hero, microsite or above-the-fold layout, or a prompt for Lovable, Bolt or v0 to build one, including regulated (prescription drug, health, finance), multilingual or market-specific launches. Covers page types (home, product, pricing, about, blog), conversion and ethical persuasion, responsive and fluid layouts, Core Web Vitals, SEO and structured data, localization and language-law requirements, stack and CMS choice (Astro, Next.js, WordPress, Webflow, Framer) and launch QA.

★ 2
newmindsgroup
newmindsgroup/visual-design-kit

ux-design

Load before designing or reviewing any flow, form, onboarding, navigation or content for real users, especially low-literacy, older, neurodivergent, child or other specific audiences. Covers research and usability tests, heuristic reviews, personas and jobs to be done, journeys and service blueprints, information architecture, UX laws, SUS, SEQ and HEART metrics, plain language and reading level, and microcopy and error messages.

★ 2
newmindsgroup
newmindsgroup/visual-design-kit

ui-design

Load before designing or specifying any interface screen or component, even a quick one: forms, tables, navigation, dashboards, onboarding, auth and passkeys, pricing, checkout, search and filters, settings, empty, loading and error states, notifications, consent and age-appropriate flows, and AI chat and agent interfaces, all to WCAG 2.2 AA. Also picks React UI libraries (toasts, drawers, command menus). Gives component specs, state matrices, sizes, density and keyboard and accessibility behavior.

★ 2
newmindsgroup
newmindsgroup/visual-design-kit

typography

Choose, pair, size and set type for brand, web, app, print, slides, signage and motion: modular scales, fluid clamp() type, measure, leading, tracking, OpenType features, font licensing and web font loading, and multiscript setting for CJK, Arabic, Hebrew, Devanagari and Thai. Use when selecting or pairing fonts, building a type scale or type tokens, fixing weak hierarchy or bad line breaks, setting long-form text or numbers, loading web fonts, or localizing type for another market.

★ 2
newmindsgroup
newmindsgroup/visual-design-kit

reference-reconstruction

Reconstructs the observed interface and behavior of a supplied app, site or screenshot set using a screen index, measurements, state and command maps, reusable components and matched-condition comparisons. Use when asked to reverse engineer, clone, reproduce or match a reference product, then adapt it if requested.

★ 2
newmindsgroup
newmindsgroup/visual-design-kit

print-packaging-social

Load before any print, packaging, label, barcode, social, out-of-home, slide-deck or email design question, even a quick one, and before making finished collateral files. Specs: bleed, safe zones, 300ppi, CMYK, PDF/X preflight, dielines, barcodes, social formats with 9:16 safe areas, billboard letter heights, 16:9 decks, bulletproof email. Renders token-driven brand books, sell sheets, cards, carousels and decks to PDF and PNG with a Canva editable twin.

★ 2