[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CSP4CM3DNBF3SBFBX4GQ2R":3,"skill-same:01M7CSP4CM3DNBF3SBFBX4GQ2R":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7CSP4CM3DNBF3SBFBX4GQ2R","icon-design",null,"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.","newmindsgroup\u002Fvisual-design-kit","newmindsgroup","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F38358889?v=4","01M7CRXVBNJ0WGRTNWHWY2HVQ9","01M7CRXVC9ZXSZBAPZTP3Y39CA",2,"MIT","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Ficon-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: icon-design\ndescription: >-\n  Designs coherent UI icon families and original application icons, from concept and vector geometry to semantic\n  registries, optical sizes, accessible controls and platform exports. Use when creating, extending, reconstructing\n  or auditing icons, a pictogram set, an app icon, a Dock icon or Icon Composer artwork.\nlicense: MIT\nmetadata:\n  version-timestamp: \"2026-10-27 11:36:23 UTC\"\n  agent-attribution: \"computer=NMG-MBP-M5.local; tool=Codex; version=codex-cli 0.160.0; timestamp=2026-10-27 11:36:23 UTC\"\n---\n\n# Icon design\n\nAn 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.\n\n## Defaults\n\n| Decision | Starting point | Change when |\n| --- | --- | --- |\n| Authority | Accepted project DESIGN.md, tokens and icon registry | A requested reconstruction keeps measured reference geometry in a separate candidate |\n| UI canvas | 24x24 viewBox, 2-unit nominal stroke, 2-unit safe inset | Extend the existing family's grid and stroke first |\n| 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 |\n| Geometry | Consistent caps, joins, corner family and apparent weight | A recognizable object needs an intentional documented exception |\n| Family selection | One licensed system or one original family | Mix only with a measured visual correction and named replacement plan |\n| Naming | Semantic registry keys such as `addItem`, `archive`, `syncError` | Preserve published keys; deprecate instead of silently renaming |\n| Color | Semantic foreground token, usually one color | State meaning adds text or shape; never color alone |\n| UI state | Rest, hover, pressed, selected, focused, disabled, busy where applicable | Platform components own states they already implement |\n| Icon-only action | Native Button or semantic HTML button with an accessible action name | Decorative icons are hidden from accessibility APIs |\n| Web target | 24x24 CSS px minimum hit region; 44x44 preferred for touch | Larger audience or device requirements override |\n| App icon | Three different object\u002Fsilhouette concepts, one clear idea each | A locked accepted concept needs refinement rather than new concepts |\n| App source | Editable vector or layered platform source plus export receipt | Existing licensed bitmap masters can remain authoritative |\n| Iteration | Change one cause per round; inspect at actual sizes | A concept failure warrants a new silhouette rather than detail polishing |\n\n## Workflow\n\n1. **Identify the job.** UI glyph family, custom illustration pictograms, application icon, or all three. Record target platforms, sizes, appearances, current assets and allowed change.\n2. **Read the project authority.** Inspect its icon registry, tokens, approved marks and licensing. Reuse accepted geometry before proposing another family.\n3. **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.\n4. **Set the grammar.** Specify canvas, live area, stroke, caps, joins, corner rules, optical correction, fill policy and baseline. Follow [UI and app icons](references\u002Fui-app-icons.md).\n5. **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.\n6. **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.\n7. **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.\n8. **Implement real controls.** Keep hit area separate from artwork bounds. Add accessible labels, tooltip and keyboard route when relevant, and selected\u002Fbusy semantics on the owning control.\n9. **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.\n10. **Inspect in context.** Place the icons in representative toolbar, navigation, table and error states. Compare weight beside text and alignment against neighboring controls.\n11. **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.\n12. **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.\n\n## Decisions that change the answer\n\n- **Reference reconstruction:** measure the source family's geometry and complete observed states first. Preserve exact observed behavior; list intentional adaptations separately when requested.\n- **Brand:** the approved project system overrides kit geometry and material defaults. An app icon may carry brand character more strongly than utility glyphs.\n- **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.\n- **Density:** dense desktop tools may use 16pt artwork inside native controls; touch interfaces need larger hit regions without automatically enlarging the glyph.\n- **Writing direction:** mirror direction-dependent actions such as forward\u002Fback where the platform does; preserve symbols whose meaning is fixed, and test the actual RTL layout.\n- **Complexity:** a small icon cannot explain a detailed workflow. Pair unfamiliar symbols with visible text instead of inventing more detail.\n- **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.\n\n## Common failures\n\n- A mixed 1.5-unit and 2-unit stroke family: normalize apparent weight, then inspect circles, diagonals and dense forms together.\n- A glyph looks centered numerically but leans visually: apply a documented optical offset and compare at actual size.\n- A shape with a click handler replaces a button: restore the native control and style its contents.\n- Tooltip is the only accessible name: provide an action label on the control, then add the tooltip as supplementary help.\n- A static icon implies selected or busy without state semantics: bind the owning control's state and test its announcement.\n- An app icon is a miniature screen or wordmark: reduce to one original silhouette and test it at 16.\n- A vendor symbol is repurposed into an application icon without checking its license: replace it with an original design or a permitted asset.\n- The export looks correct only when enlarged: fix the smallest optical variant before adding detail.\n\n## References\n\n- [UI and application icons](references\u002Fui-app-icons.md): geometry, registry, optical variants, interaction and platform export checks.\n- [Design system](..\u002Fdesign-system\u002FSKILL.md): project tokens, component APIs and versioned adoption.\n- [Native app design](..\u002Fnative-app-design\u002FSKILL.md) and [macOS](..\u002Fnative-app-design\u002Freferences\u002Fmacos.md): native controls and the layered Mac icon toolchain.\n- [Reference reconstruction](..\u002Freference-reconstruction\u002FSKILL.md): observed icon measurements and source-bound fidelity.\n- [UI system process](..\u002F..\u002Flibrary\u002Fdraft-skills\u002Fdesign-ui-system\u002FSKILL.md): component and state records for client projects.\n- [BAMA app-icon source](https:\u002F\u002Fgithub.com\u002Fdaveebbelaar\u002Fbama\u002Ftree\u002F15356bd8ebff408222ad21395aea09bd74b15310\u002Fskills\u002Fdesign\u002Fapp-icon): pinned upstream method behind the platform specialization.\n\nCatalog IDs covered: icon-design, ui, identity, production\n","# Icon design\n\nAn 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.\n\n## Defaults\n\n| Decision | Starting point | Change when |\n| --- | --- | --- |\n| Authority | Accepted project DESIGN.md, tokens and icon registry | A requested reconstruction keeps measured reference geometry in a separate candidate |\n| UI canvas | 24x24 viewBox, 2-unit nominal stroke, 2-unit safe inset | Extend the existing family's grid and stroke first |\n| 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 |\n| Geometry | Consistent caps, joins, corner family and apparent weight | A recognizable object needs an intentional documented exception |\n| Family selection | One licensed system or one original family | Mix only with a measured visual correction and named replacement plan |\n| Naming | Semantic registry keys such as `addItem`, `archive`, `syncError` | Preserve published keys; deprecate instead of silently renaming |\n| Color | Semantic foreground token, usually one color | State meaning adds text or shape; never color alone |\n| UI state | Rest, hover, pressed, selected, focused, disabled, busy where applicable | Platform components own states they already implement |\n| Icon-only action | Native Button or semantic HTML button with an accessible action name | Decorative icons are hidden from accessibility APIs |\n| Web target | 24x24 CSS px minimum hit region; 44x44 preferred for touch | Larger audience or device requirements override |\n| App icon | Three different object\u002Fsilhouette concepts, one clear idea each | A locked accepted concept needs refinement rather than new concepts |\n| App source | Editable vector or layered platform source plus export receipt | Existing licensed bitmap masters can remain authoritative |\n| Iteration | Change one cause per round; inspect at actual sizes | A concept failure warrants a new silhouette rather than detail polishing |\n\n## Workflow\n\n1. **Identify the job.** UI glyph family, custom illustration pictograms, application icon, or all three. Record target platforms, sizes, appearances, current assets and allowed change.\n2. **Read the project authority.** Inspect its icon registry, tokens, approved marks and licensing. Reuse accepted geometry before proposing another family.\n3. **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.\n4. **Set the grammar.** Specify canvas, live area, stroke, caps, joins, corner rules, optical correction, fill policy and baseline. Follow [UI and app icons](references\u002Fui-app-icons.md).\n5. **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.\n6. **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.\n7. **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.\n8. **Implement real controls.** Keep hit area separate from artwork bounds. Add accessible labels, tooltip and keyboard route when relevant, and selected\u002Fbusy semantics on the owning control.\n9. **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.\n10. **Inspect in context.** Place the icons in representative toolbar, navigation, table and error states. Compare weight beside text and alignment against neighboring controls.\n11. **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.\n12. **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.\n\n## Decisions that change the answer\n\n- **Reference reconstruction:** measure the source family's geometry and complete observed states first. Preserve exact observed behavior; list intentional adaptations separately when requested.\n- **Brand:** the approved project system overrides kit geometry and material defaults. An app icon may carry brand character more strongly than utility glyphs.\n- **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.\n- **Density:** dense desktop tools may use 16pt artwork inside native controls; touch interfaces need larger hit regions without automatically enlarging the glyph.\n- **Writing direction:** mirror direction-dependent actions such as forward\u002Fback where the platform does; preserve symbols whose meaning is fixed, and test the actual RTL layout.\n- **Complexity:** a small icon cannot explain a detailed workflow. Pair unfamiliar symbols with visible text instead of inventing more detail.\n- **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.\n\n## Common failures\n\n- A mixed 1.5-unit and 2-unit stroke family: normalize apparent weight, then inspect circles, diagonals and dense forms together.\n- A glyph looks centered numerically but leans visually: apply a documented optical offset and compare at actual size.\n- A shape with a click handler replaces a button: restore the native control and style its contents.\n- Tooltip is the only accessible name: provide an action label on the control, then add the tooltip as supplementary help.\n- A static icon implies selected or busy without state semantics: bind the owning control's state and test its announcement.\n- An app icon is a miniature screen or wordmark: reduce to one original silhouette and test it at 16.\n- A vendor symbol is repurposed into an application icon without checking its license: replace it with an original design or a permitted asset.\n- The export looks correct only when enlarged: fix the smallest optical variant before adding detail.\n\n## References\n\n- [UI and application icons](references\u002Fui-app-icons.md): geometry, registry, optical variants, interaction and platform export checks.\n- [Design system](..\u002Fdesign-system\u002FSKILL.md): project tokens, component APIs and versioned adoption.\n- [Native app design](..\u002Fnative-app-design\u002FSKILL.md) and [macOS](..\u002Fnative-app-design\u002Freferences\u002Fmacos.md): native controls and the layered Mac icon toolchain.\n- [Reference reconstruction](..\u002Freference-reconstruction\u002FSKILL.md): observed icon measurements and source-bound fidelity.\n- [UI system process](..\u002F..\u002Flibrary\u002Fdraft-skills\u002Fdesign-ui-system\u002FSKILL.md): component and state records for client projects.\n- [BAMA app-icon source](https:\u002F\u002Fgithub.com\u002Fdaveebbelaar\u002Fbama\u002Ftree\u002F15356bd8ebff408222ad21395aea09bd74b15310\u002Fskills\u002Fdesign\u002Fapp-icon): pinned upstream method behind the platform specialization.\n\nCatalog IDs covered: icon-design, ui, identity, production\n",{"name":5,"license":14,"metadata":23,"description":7},{"agent-attribution":24,"version-timestamp":25},"computer=NMG-MBP-M5.local; tool=Codex; version=codex-cli 0.160.0; timestamp=2026-10-27 11:36:23 UTC","2026-10-27 11:36:23 UTC","main","753c596e097d0288f4f74e22d6b8457014eac8b2","plugins\u002Fvisual-design-studio\u002Fskills\u002Ficon-design",0,"https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup","2026-11-10 11:31:50",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add newmindsgroup\u002Fvisual-design-kit --skill icon-design",{"tool":39,"command":40},"bunx","bunx skills add newmindsgroup\u002Fvisual-design-kit --skill icon-design",{"tool":42,"command":43},"pnpm","pnpm dlx skills add newmindsgroup\u002Fvisual-design-kit --skill icon-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Ficon-design\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fui-app-icons.md","REFERENCE","参考文档",7826,"https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Ficon-design\u002Freferences\u002Fui-app-icons.md",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7CSR2BPCD04SARPWN7EJ5R0","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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Fweb-design\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7CSQX00CVQAWP2QDHKVXFMS","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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Fux-design\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7CSQQE0HX6Q8YR2EA1TR6P4","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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Fui-design\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7CSQFM0F9QKZ17S54PYN8M7","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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Ftypography\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7CSQ95PB7K9JBEFYZVA7226","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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Freference-reconstruction\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M7CSQ1XRH2MBXH21MSZ7PXWJ","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\u002FX 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.","https:\u002F\u002Fgithub.com\u002Fnewmindsgroup\u002Fvisual-design-kit\u002Fblob\u002Fmain\u002Fplugins\u002Fvisual-design-studio\u002Fskills\u002Fprint-packaging-social\u002FSKILL.md",[],[]]