[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-liquid-glass":3,"mdc-5yk1yz-key":39,"related-repo-openai-liquid-glass":791,"related-org-openai-liquid-glass":911},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":28,"repoUrl":29,"updatedAt":30,"license":31,"forks":32,"topics":33,"repo":34,"sourceUrl":37,"mdContent":38},"liquid-glass","implement Liquid Glass SwiftUI designs","Implement and review macOS SwiftUI Liquid Glass UI. Use when adopting system glass, removing conflicting custom chrome, or building glass surfaces.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19,22,25],{"name":13,"slug":14,"type":15},"SwiftUI","swiftui","tag",{"name":17,"slug":18,"type":15},"macOS","macos",{"name":20,"slug":21,"type":15},"Design System","design-system",{"name":23,"slug":24,"type":15},"Frontend","frontend",{"name":26,"slug":27,"type":15},"Design","design",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-04-08T20:37:35.449902",null,465,[],{"repoUrl":29,"stars":28,"forks":32,"topics":35,"description":36},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Fbuild-macos-apps\u002Fskills\u002Fliquid-glass","---\nname: liquid-glass\ndescription: Implement and review macOS SwiftUI Liquid Glass UI. Use when adopting system glass, removing conflicting custom chrome, or building glass surfaces.\n---\n\n# Liquid Glass\n\n## Overview\n\nUse this skill to bring a macOS SwiftUI app into the modern macOS design system\nwith the least custom chrome possible. Start with standard app structure,\ntoolbars, search placement, sheets, and controls, then add custom Liquid Glass\nonly where the app needs a distinctive surface.\n\nPrefer system-provided glass and adaptive materials over bespoke blur, opaque\nbackgrounds, or custom toolbar\u002Fsidebar skins. Audit existing UI for extra fills,\nscrims, and clipping before adding more effects.\n\n## Workflow\n\n1. Read the relevant scene or root view and identify the structural pattern:\n   `NavigationSplitView`, `TabView`, sheet presentation, detail\u002Finspector\n   layout, toolbar, or custom floating controls.\n2. Remove custom backgrounds or darkening layers behind system sheets,\n   sidebars, and toolbars unless the product explicitly needs them. These can\n   obscure Liquid Glass and interfere with the automatic scroll-edge effect.\n3. Update standard SwiftUI structure and controls first.\n4. Add custom `glassEffect` surfaces only for app-specific UI that standard\n   controls do not cover.\n5. Validate that glass grouping, transitions, icon treatment, and foreground\n   activation are visually coherent and still usable with pointer and keyboard.\n6. If the UI change also affects launch behavior for a SwiftPM GUI app, use\n   `build-run-debug` so the app runs as a foreground `.app` bundle rather\n   than as a raw executable.\n\n## App Structure\n\n- Prefer `NavigationSplitView` for hierarchy-driven macOS layouts. Let the\n  sidebar use the system Liquid Glass material instead of painting over it.\n- For hero artwork or large media adjacent to a floating sidebar, use\n  `backgroundExtensionEffect` so the visual can extend beyond the safe area\n  without clipping the subject.\n- Keep inspectors visually associated with the current selection and avoid\n  giving them a heavier custom background than the content they inspect.\n- If the app uses tabs, keep `TabView` for persistent top-level sections and\n  preserve each tab's local navigation state.\n- Do not force iPhone-only tab bar minimize\u002Faccessory behavior onto a Mac app.\n  On macOS, prefer a conventional top toolbar and native tab\u002Fsearch placement.\n- If a sheet already uses `presentationBackground` purely to imitate frosted\n  material, consider removing it and letting the system's new material render.\n- For sheet transitions that should visually originate from a toolbar button,\n  make the presenting item the source of a navigation zoom transition and mark\n  the sheet content as the destination.\n\n## Toolbars\n\n- Assume toolbar items are rendered on a floating Liquid Glass surface and are\n  grouped automatically.\n- Use `ToolbarSpacer` to communicate grouping:\n  - fixed spacing to split related actions into a distinct group,\n  - flexible spacing to push a leading action away from a trailing group.\n- Use `sharedBackgroundVisibility` when an item should stand alone without the\n  shared glass background, for example a profile\u002Favatar item.\n- Add `badge` to toolbar item content for notification or status indicators.\n- Expect monochrome icon rendering in more toolbar contexts. Use `tint` only to\n  convey semantic meaning such as a primary action or alert state, not as pure\n  decoration.\n- If content underneath a toolbar has extra darkening, blur, or custom\n  background layers, remove them before judging the new automatic scroll-edge\n  effect.\n- For dense windows with many floating elements, tune the content's scroll-edge\n  treatment with `scrollEdgeEffectStyle` instead of building a custom bar\n  background.\n\n## Search\n\n- For a search field that applies across a whole split-view hierarchy, attach\n  `searchable` to the `NavigationSplitView`, not to just one column.\n- When search is secondary and a compact affordance is better, use\n  `searchToolbarBehavior` instead of hand-rolling a toolbar button and a\n  separate field.\n- For a dedicated search page in a multi-tab app, assign the search role to one\n  tab and place `searchable` on the `TabView`.\n- Make most of the app's content discoverable from search when the field lives\n  in the top-trailing toolbar location.\n- On iPad and Mac, expect the dedicated search tab to show a centered field\n  above browsing suggestions rather than a bottom search bar.\n\n## Controls\n\n- Prefer standard SwiftUI controls before creating custom glass components.\n- Expect bordered buttons to default to a capsule shape at larger sizes. On\n  macOS, mini\u002Fsmall\u002Fmedium controls preserve a rounded-rectangle shape for\n  denser layouts.\n- Use `buttonBorderShape` when a button shape needs to be explicit.\n- Use `controlSize` to preserve density in inspectors and popovers, and reserve\n  extra-large sizing for truly prominent actions.\n- Use the system glass and glass-prominent button styles for primary actions\n  instead of recreating a translucent button background by hand.\n- For sliders with discrete values, pass `step` to get automatic tick marks or\n  provide specific ticks in a `ticks` closure.\n- For sliders that should expand left and right around a baseline, set\n  `neutralValue`.\n- Use `Label` or standard control initializers for menu items so icons are\n  consistently placed on the leading edge across platforms.\n- For custom shapes that must align concentrically with a sheet, card, or\n  window corner, use a concentric rectangle shape with the\n  `containerConcentric` corner configuration instead of guessing a radius.\n\n## Custom Liquid Glass\n\n- Use `glassEffect` for custom glass surfaces. The default shape is capsule-like\n  and text foregrounds are automatically made vibrant and legible against\n  changing content underneath.\n- Pass an explicit shape to `glassEffect` when a capsule is not the right fit.\n- Add `tint` only when color carries meaning, such as a status or call to\n  action.\n- Use `glassEffect(... .interactive())` for custom controls or containers with\n  interactive elements so they scale, bounce, and shimmer like system glass.\n- Wrap nearby custom glass elements in one `GlassEffectContainer`. This is a\n  visual correctness rule, not just organization: separate containers cannot\n  sample each other's glass and can produce inconsistent refraction.\n- Use `glassEffectID` with a local `@Namespace` when matching glass elements\n  should morph between collapsed and expanded states.\n\n## Review Checklist\n\n- Standard structures and controls were updated first before adding custom\n  glass.\n- Opaque backgrounds, dark scrims, and custom toolbar\u002Fsheet fills that fight the\n  system material were removed unless intentionally required.\n- `searchable` is attached at the correct container level for the intended\n  search scope.\n- Toolbar grouping uses `ToolbarSpacer`, `sharedBackgroundVisibility`, and\n  `badge` instead of one-off hand-built chrome.\n- Icon tint is semantic, not decorative.\n- Custom glass elements that sit near each other share a\n  `GlassEffectContainer`.\n- Morphing glass transitions use `glassEffectID` with a namespace and stable\n  identity.\n- Any SwiftPM GUI app used to test the result is launched as a `.app` bundle,\n  not as a raw executable.\n\n## Guardrails\n\n- Do not rebuild system sidebars, toolbars, sheets, or controls from scratch if\n  standard SwiftUI APIs already provide the modern macOS behavior.\n- Do not apply custom opaque backgrounds behind a `NavigationSplitView`\n  sidebar, system toolbar, or sheet just because an older version needed\n  one.\n- Do not scatter related glass elements across multiple\n  `GlassEffectContainer`s.\n- Do not tint every icon or glass surface for visual variety alone.\n- Do not assume an iPhone tab\u002Fsearch behavior is the right answer on macOS.\n  Prefer desktop-native toolbar, split-view, and inspector placement.\n- Do not leave a GUI SwiftPM app launching as a bare executable when reviewing\n  Liquid Glass behavior; missing foreground activation can make a design bug\n  look like a rendering bug.\n\n## When To Use Other Skills\n\n- Use `swiftui-patterns` when the main question is scene architecture,\n  sidebar\u002Fdetail layout, commands, or settings rather than Liquid Glass-specific\n  treatment.\n- Use `view-refactor` when the main issue is file structure, state\n  ownership, and extracting large views before design changes.\n- Use `appkit-interop` when the design requires window, panel, responder-chain,\n  or AppKit-only control behavior.\n- Use `build-run-debug` when you need to launch, verify, or inspect logs\n  for the app after the visual update.\n",{"data":40,"body":41},{"name":4,"description":6},{"type":42,"children":43},"root",[44,52,59,65,70,76,152,158,227,233,323,329,394,400,500,506,588,594,682,688,735,741],{"type":45,"tag":46,"props":47,"children":48},"element","h1",{"id":4},[49],{"type":50,"value":51},"text","Liquid Glass",{"type":45,"tag":53,"props":54,"children":56},"h2",{"id":55},"overview",[57],{"type":50,"value":58},"Overview",{"type":45,"tag":60,"props":61,"children":62},"p",{},[63],{"type":50,"value":64},"Use this skill to bring a macOS SwiftUI app into the modern macOS design system\nwith the least custom chrome possible. Start with standard app structure,\ntoolbars, search placement, sheets, and controls, then add custom Liquid Glass\nonly where the app needs a distinctive surface.",{"type":45,"tag":60,"props":66,"children":67},{},[68],{"type":50,"value":69},"Prefer system-provided glass and adaptive materials over bespoke blur, opaque\nbackgrounds, or custom toolbar\u002Fsidebar skins. Audit existing UI for extra fills,\nscrims, and clipping before adding more effects.",{"type":45,"tag":53,"props":71,"children":73},{"id":72},"workflow",[74],{"type":50,"value":75},"Workflow",{"type":45,"tag":77,"props":78,"children":79},"ol",{},[80,103,108,113,126,131],{"type":45,"tag":81,"props":82,"children":83},"li",{},[84,86,93,95,101],{"type":50,"value":85},"Read the relevant scene or root view and identify the structural pattern:\n",{"type":45,"tag":87,"props":88,"children":90},"code",{"className":89},[],[91],{"type":50,"value":92},"NavigationSplitView",{"type":50,"value":94},", ",{"type":45,"tag":87,"props":96,"children":98},{"className":97},[],[99],{"type":50,"value":100},"TabView",{"type":50,"value":102},", sheet presentation, detail\u002Finspector\nlayout, toolbar, or custom floating controls.",{"type":45,"tag":81,"props":104,"children":105},{},[106],{"type":50,"value":107},"Remove custom backgrounds or darkening layers behind system sheets,\nsidebars, and toolbars unless the product explicitly needs them. These can\nobscure Liquid Glass and interfere with the automatic scroll-edge effect.",{"type":45,"tag":81,"props":109,"children":110},{},[111],{"type":50,"value":112},"Update standard SwiftUI structure and controls first.",{"type":45,"tag":81,"props":114,"children":115},{},[116,118,124],{"type":50,"value":117},"Add custom ",{"type":45,"tag":87,"props":119,"children":121},{"className":120},[],[122],{"type":50,"value":123},"glassEffect",{"type":50,"value":125}," surfaces only for app-specific UI that standard\ncontrols do not cover.",{"type":45,"tag":81,"props":127,"children":128},{},[129],{"type":50,"value":130},"Validate that glass grouping, transitions, icon treatment, and foreground\nactivation are visually coherent and still usable with pointer and keyboard.",{"type":45,"tag":81,"props":132,"children":133},{},[134,136,142,144,150],{"type":50,"value":135},"If the UI change also affects launch behavior for a SwiftPM GUI app, use\n",{"type":45,"tag":87,"props":137,"children":139},{"className":138},[],[140],{"type":50,"value":141},"build-run-debug",{"type":50,"value":143}," so the app runs as a foreground ",{"type":45,"tag":87,"props":145,"children":147},{"className":146},[],[148],{"type":50,"value":149},".app",{"type":50,"value":151}," bundle rather\nthan as a raw executable.",{"type":45,"tag":53,"props":153,"children":155},{"id":154},"app-structure",[156],{"type":50,"value":157},"App Structure",{"type":45,"tag":159,"props":160,"children":161},"ul",{},[162,174,187,192,204,209,222],{"type":45,"tag":81,"props":163,"children":164},{},[165,167,172],{"type":50,"value":166},"Prefer ",{"type":45,"tag":87,"props":168,"children":170},{"className":169},[],[171],{"type":50,"value":92},{"type":50,"value":173}," for hierarchy-driven macOS layouts. Let the\nsidebar use the system Liquid Glass material instead of painting over it.",{"type":45,"tag":81,"props":175,"children":176},{},[177,179,185],{"type":50,"value":178},"For hero artwork or large media adjacent to a floating sidebar, use\n",{"type":45,"tag":87,"props":180,"children":182},{"className":181},[],[183],{"type":50,"value":184},"backgroundExtensionEffect",{"type":50,"value":186}," so the visual can extend beyond the safe area\nwithout clipping the subject.",{"type":45,"tag":81,"props":188,"children":189},{},[190],{"type":50,"value":191},"Keep inspectors visually associated with the current selection and avoid\ngiving them a heavier custom background than the content they inspect.",{"type":45,"tag":81,"props":193,"children":194},{},[195,197,202],{"type":50,"value":196},"If the app uses tabs, keep ",{"type":45,"tag":87,"props":198,"children":200},{"className":199},[],[201],{"type":50,"value":100},{"type":50,"value":203}," for persistent top-level sections and\npreserve each tab's local navigation state.",{"type":45,"tag":81,"props":205,"children":206},{},[207],{"type":50,"value":208},"Do not force iPhone-only tab bar minimize\u002Faccessory behavior onto a Mac app.\nOn macOS, prefer a conventional top toolbar and native tab\u002Fsearch placement.",{"type":45,"tag":81,"props":210,"children":211},{},[212,214,220],{"type":50,"value":213},"If a sheet already uses ",{"type":45,"tag":87,"props":215,"children":217},{"className":216},[],[218],{"type":50,"value":219},"presentationBackground",{"type":50,"value":221}," purely to imitate frosted\nmaterial, consider removing it and letting the system's new material render.",{"type":45,"tag":81,"props":223,"children":224},{},[225],{"type":50,"value":226},"For sheet transitions that should visually originate from a toolbar button,\nmake the presenting item the source of a navigation zoom transition and mark\nthe sheet content as the destination.",{"type":45,"tag":53,"props":228,"children":230},{"id":229},"toolbars",[231],{"type":50,"value":232},"Toolbars",{"type":45,"tag":159,"props":234,"children":235},{},[236,241,267,279,292,305,310],{"type":45,"tag":81,"props":237,"children":238},{},[239],{"type":50,"value":240},"Assume toolbar items are rendered on a floating Liquid Glass surface and are\ngrouped automatically.",{"type":45,"tag":81,"props":242,"children":243},{},[244,246,252,254],{"type":50,"value":245},"Use ",{"type":45,"tag":87,"props":247,"children":249},{"className":248},[],[250],{"type":50,"value":251},"ToolbarSpacer",{"type":50,"value":253}," to communicate grouping:\n",{"type":45,"tag":159,"props":255,"children":256},{},[257,262],{"type":45,"tag":81,"props":258,"children":259},{},[260],{"type":50,"value":261},"fixed spacing to split related actions into a distinct group,",{"type":45,"tag":81,"props":263,"children":264},{},[265],{"type":50,"value":266},"flexible spacing to push a leading action away from a trailing group.",{"type":45,"tag":81,"props":268,"children":269},{},[270,271,277],{"type":50,"value":245},{"type":45,"tag":87,"props":272,"children":274},{"className":273},[],[275],{"type":50,"value":276},"sharedBackgroundVisibility",{"type":50,"value":278}," when an item should stand alone without the\nshared glass background, for example a profile\u002Favatar item.",{"type":45,"tag":81,"props":280,"children":281},{},[282,284,290],{"type":50,"value":283},"Add ",{"type":45,"tag":87,"props":285,"children":287},{"className":286},[],[288],{"type":50,"value":289},"badge",{"type":50,"value":291}," to toolbar item content for notification or status indicators.",{"type":45,"tag":81,"props":293,"children":294},{},[295,297,303],{"type":50,"value":296},"Expect monochrome icon rendering in more toolbar contexts. Use ",{"type":45,"tag":87,"props":298,"children":300},{"className":299},[],[301],{"type":50,"value":302},"tint",{"type":50,"value":304}," only to\nconvey semantic meaning such as a primary action or alert state, not as pure\ndecoration.",{"type":45,"tag":81,"props":306,"children":307},{},[308],{"type":50,"value":309},"If content underneath a toolbar has extra darkening, blur, or custom\nbackground layers, remove them before judging the new automatic scroll-edge\neffect.",{"type":45,"tag":81,"props":311,"children":312},{},[313,315,321],{"type":50,"value":314},"For dense windows with many floating elements, tune the content's scroll-edge\ntreatment with ",{"type":45,"tag":87,"props":316,"children":318},{"className":317},[],[319],{"type":50,"value":320},"scrollEdgeEffectStyle",{"type":50,"value":322}," instead of building a custom bar\nbackground.",{"type":45,"tag":53,"props":324,"children":326},{"id":325},"search",[327],{"type":50,"value":328},"Search",{"type":45,"tag":159,"props":330,"children":331},{},[332,352,365,384,389],{"type":45,"tag":81,"props":333,"children":334},{},[335,337,343,345,350],{"type":50,"value":336},"For a search field that applies across a whole split-view hierarchy, attach\n",{"type":45,"tag":87,"props":338,"children":340},{"className":339},[],[341],{"type":50,"value":342},"searchable",{"type":50,"value":344}," to the ",{"type":45,"tag":87,"props":346,"children":348},{"className":347},[],[349],{"type":50,"value":92},{"type":50,"value":351},", not to just one column.",{"type":45,"tag":81,"props":353,"children":354},{},[355,357,363],{"type":50,"value":356},"When search is secondary and a compact affordance is better, use\n",{"type":45,"tag":87,"props":358,"children":360},{"className":359},[],[361],{"type":50,"value":362},"searchToolbarBehavior",{"type":50,"value":364}," instead of hand-rolling a toolbar button and a\nseparate field.",{"type":45,"tag":81,"props":366,"children":367},{},[368,370,375,377,382],{"type":50,"value":369},"For a dedicated search page in a multi-tab app, assign the search role to one\ntab and place ",{"type":45,"tag":87,"props":371,"children":373},{"className":372},[],[374],{"type":50,"value":342},{"type":50,"value":376}," on the ",{"type":45,"tag":87,"props":378,"children":380},{"className":379},[],[381],{"type":50,"value":100},{"type":50,"value":383},".",{"type":45,"tag":81,"props":385,"children":386},{},[387],{"type":50,"value":388},"Make most of the app's content discoverable from search when the field lives\nin the top-trailing toolbar location.",{"type":45,"tag":81,"props":390,"children":391},{},[392],{"type":50,"value":393},"On iPad and Mac, expect the dedicated search tab to show a centered field\nabove browsing suggestions rather than a bottom search bar.",{"type":45,"tag":53,"props":395,"children":397},{"id":396},"controls",[398],{"type":50,"value":399},"Controls",{"type":45,"tag":159,"props":401,"children":402},{},[403,408,413,425,437,442,463,475,487],{"type":45,"tag":81,"props":404,"children":405},{},[406],{"type":50,"value":407},"Prefer standard SwiftUI controls before creating custom glass components.",{"type":45,"tag":81,"props":409,"children":410},{},[411],{"type":50,"value":412},"Expect bordered buttons to default to a capsule shape at larger sizes. On\nmacOS, mini\u002Fsmall\u002Fmedium controls preserve a rounded-rectangle shape for\ndenser layouts.",{"type":45,"tag":81,"props":414,"children":415},{},[416,417,423],{"type":50,"value":245},{"type":45,"tag":87,"props":418,"children":420},{"className":419},[],[421],{"type":50,"value":422},"buttonBorderShape",{"type":50,"value":424}," when a button shape needs to be explicit.",{"type":45,"tag":81,"props":426,"children":427},{},[428,429,435],{"type":50,"value":245},{"type":45,"tag":87,"props":430,"children":432},{"className":431},[],[433],{"type":50,"value":434},"controlSize",{"type":50,"value":436}," to preserve density in inspectors and popovers, and reserve\nextra-large sizing for truly prominent actions.",{"type":45,"tag":81,"props":438,"children":439},{},[440],{"type":50,"value":441},"Use the system glass and glass-prominent button styles for primary actions\ninstead of recreating a translucent button background by hand.",{"type":45,"tag":81,"props":443,"children":444},{},[445,447,453,455,461],{"type":50,"value":446},"For sliders with discrete values, pass ",{"type":45,"tag":87,"props":448,"children":450},{"className":449},[],[451],{"type":50,"value":452},"step",{"type":50,"value":454}," to get automatic tick marks or\nprovide specific ticks in a ",{"type":45,"tag":87,"props":456,"children":458},{"className":457},[],[459],{"type":50,"value":460},"ticks",{"type":50,"value":462}," closure.",{"type":45,"tag":81,"props":464,"children":465},{},[466,468,474],{"type":50,"value":467},"For sliders that should expand left and right around a baseline, set\n",{"type":45,"tag":87,"props":469,"children":471},{"className":470},[],[472],{"type":50,"value":473},"neutralValue",{"type":50,"value":383},{"type":45,"tag":81,"props":476,"children":477},{},[478,479,485],{"type":50,"value":245},{"type":45,"tag":87,"props":480,"children":482},{"className":481},[],[483],{"type":50,"value":484},"Label",{"type":50,"value":486}," or standard control initializers for menu items so icons are\nconsistently placed on the leading edge across platforms.",{"type":45,"tag":81,"props":488,"children":489},{},[490,492,498],{"type":50,"value":491},"For custom shapes that must align concentrically with a sheet, card, or\nwindow corner, use a concentric rectangle shape with the\n",{"type":45,"tag":87,"props":493,"children":495},{"className":494},[],[496],{"type":50,"value":497},"containerConcentric",{"type":50,"value":499}," corner configuration instead of guessing a radius.",{"type":45,"tag":53,"props":501,"children":503},{"id":502},"custom-liquid-glass",[504],{"type":50,"value":505},"Custom Liquid Glass",{"type":45,"tag":159,"props":507,"children":508},{},[509,520,532,543,555,568],{"type":45,"tag":81,"props":510,"children":511},{},[512,513,518],{"type":50,"value":245},{"type":45,"tag":87,"props":514,"children":516},{"className":515},[],[517],{"type":50,"value":123},{"type":50,"value":519}," for custom glass surfaces. The default shape is capsule-like\nand text foregrounds are automatically made vibrant and legible against\nchanging content underneath.",{"type":45,"tag":81,"props":521,"children":522},{},[523,525,530],{"type":50,"value":524},"Pass an explicit shape to ",{"type":45,"tag":87,"props":526,"children":528},{"className":527},[],[529],{"type":50,"value":123},{"type":50,"value":531}," when a capsule is not the right fit.",{"type":45,"tag":81,"props":533,"children":534},{},[535,536,541],{"type":50,"value":283},{"type":45,"tag":87,"props":537,"children":539},{"className":538},[],[540],{"type":50,"value":302},{"type":50,"value":542}," only when color carries meaning, such as a status or call to\naction.",{"type":45,"tag":81,"props":544,"children":545},{},[546,547,553],{"type":50,"value":245},{"type":45,"tag":87,"props":548,"children":550},{"className":549},[],[551],{"type":50,"value":552},"glassEffect(... .interactive())",{"type":50,"value":554}," for custom controls or containers with\ninteractive elements so they scale, bounce, and shimmer like system glass.",{"type":45,"tag":81,"props":556,"children":557},{},[558,560,566],{"type":50,"value":559},"Wrap nearby custom glass elements in one ",{"type":45,"tag":87,"props":561,"children":563},{"className":562},[],[564],{"type":50,"value":565},"GlassEffectContainer",{"type":50,"value":567},". This is a\nvisual correctness rule, not just organization: separate containers cannot\nsample each other's glass and can produce inconsistent refraction.",{"type":45,"tag":81,"props":569,"children":570},{},[571,572,578,580,586],{"type":50,"value":245},{"type":45,"tag":87,"props":573,"children":575},{"className":574},[],[576],{"type":50,"value":577},"glassEffectID",{"type":50,"value":579}," with a local ",{"type":45,"tag":87,"props":581,"children":583},{"className":582},[],[584],{"type":50,"value":585},"@Namespace",{"type":50,"value":587}," when matching glass elements\nshould morph between collapsed and expanded states.",{"type":45,"tag":53,"props":589,"children":591},{"id":590},"review-checklist",[592],{"type":50,"value":593},"Review Checklist",{"type":45,"tag":159,"props":595,"children":596},{},[597,602,607,617,642,647,658,670],{"type":45,"tag":81,"props":598,"children":599},{},[600],{"type":50,"value":601},"Standard structures and controls were updated first before adding custom\nglass.",{"type":45,"tag":81,"props":603,"children":604},{},[605],{"type":50,"value":606},"Opaque backgrounds, dark scrims, and custom toolbar\u002Fsheet fills that fight the\nsystem material were removed unless intentionally required.",{"type":45,"tag":81,"props":608,"children":609},{},[610,615],{"type":45,"tag":87,"props":611,"children":613},{"className":612},[],[614],{"type":50,"value":342},{"type":50,"value":616}," is attached at the correct container level for the intended\nsearch scope.",{"type":45,"tag":81,"props":618,"children":619},{},[620,622,627,628,633,635,640],{"type":50,"value":621},"Toolbar grouping uses ",{"type":45,"tag":87,"props":623,"children":625},{"className":624},[],[626],{"type":50,"value":251},{"type":50,"value":94},{"type":45,"tag":87,"props":629,"children":631},{"className":630},[],[632],{"type":50,"value":276},{"type":50,"value":634},", and\n",{"type":45,"tag":87,"props":636,"children":638},{"className":637},[],[639],{"type":50,"value":289},{"type":50,"value":641}," instead of one-off hand-built chrome.",{"type":45,"tag":81,"props":643,"children":644},{},[645],{"type":50,"value":646},"Icon tint is semantic, not decorative.",{"type":45,"tag":81,"props":648,"children":649},{},[650,652,657],{"type":50,"value":651},"Custom glass elements that sit near each other share a\n",{"type":45,"tag":87,"props":653,"children":655},{"className":654},[],[656],{"type":50,"value":565},{"type":50,"value":383},{"type":45,"tag":81,"props":659,"children":660},{},[661,663,668],{"type":50,"value":662},"Morphing glass transitions use ",{"type":45,"tag":87,"props":664,"children":666},{"className":665},[],[667],{"type":50,"value":577},{"type":50,"value":669}," with a namespace and stable\nidentity.",{"type":45,"tag":81,"props":671,"children":672},{},[673,675,680],{"type":50,"value":674},"Any SwiftPM GUI app used to test the result is launched as a ",{"type":45,"tag":87,"props":676,"children":678},{"className":677},[],[679],{"type":50,"value":149},{"type":50,"value":681}," bundle,\nnot as a raw executable.",{"type":45,"tag":53,"props":683,"children":685},{"id":684},"guardrails",[686],{"type":50,"value":687},"Guardrails",{"type":45,"tag":159,"props":689,"children":690},{},[691,696,708,720,725,730],{"type":45,"tag":81,"props":692,"children":693},{},[694],{"type":50,"value":695},"Do not rebuild system sidebars, toolbars, sheets, or controls from scratch if\nstandard SwiftUI APIs already provide the modern macOS behavior.",{"type":45,"tag":81,"props":697,"children":698},{},[699,701,706],{"type":50,"value":700},"Do not apply custom opaque backgrounds behind a ",{"type":45,"tag":87,"props":702,"children":704},{"className":703},[],[705],{"type":50,"value":92},{"type":50,"value":707},"\nsidebar, system toolbar, or sheet just because an older version needed\none.",{"type":45,"tag":81,"props":709,"children":710},{},[711,713,718],{"type":50,"value":712},"Do not scatter related glass elements across multiple\n",{"type":45,"tag":87,"props":714,"children":716},{"className":715},[],[717],{"type":50,"value":565},{"type":50,"value":719},"s.",{"type":45,"tag":81,"props":721,"children":722},{},[723],{"type":50,"value":724},"Do not tint every icon or glass surface for visual variety alone.",{"type":45,"tag":81,"props":726,"children":727},{},[728],{"type":50,"value":729},"Do not assume an iPhone tab\u002Fsearch behavior is the right answer on macOS.\nPrefer desktop-native toolbar, split-view, and inspector placement.",{"type":45,"tag":81,"props":731,"children":732},{},[733],{"type":50,"value":734},"Do not leave a GUI SwiftPM app launching as a bare executable when reviewing\nLiquid Glass behavior; missing foreground activation can make a design bug\nlook like a rendering bug.",{"type":45,"tag":53,"props":736,"children":738},{"id":737},"when-to-use-other-skills",[739],{"type":50,"value":740},"When To Use Other Skills",{"type":45,"tag":159,"props":742,"children":743},{},[744,756,768,780],{"type":45,"tag":81,"props":745,"children":746},{},[747,748,754],{"type":50,"value":245},{"type":45,"tag":87,"props":749,"children":751},{"className":750},[],[752],{"type":50,"value":753},"swiftui-patterns",{"type":50,"value":755}," when the main question is scene architecture,\nsidebar\u002Fdetail layout, commands, or settings rather than Liquid Glass-specific\ntreatment.",{"type":45,"tag":81,"props":757,"children":758},{},[759,760,766],{"type":50,"value":245},{"type":45,"tag":87,"props":761,"children":763},{"className":762},[],[764],{"type":50,"value":765},"view-refactor",{"type":50,"value":767}," when the main issue is file structure, state\nownership, and extracting large views before design changes.",{"type":45,"tag":81,"props":769,"children":770},{},[771,772,778],{"type":50,"value":245},{"type":45,"tag":87,"props":773,"children":775},{"className":774},[],[776],{"type":50,"value":777},"appkit-interop",{"type":50,"value":779}," when the design requires window, panel, responder-chain,\nor AppKit-only control behavior.",{"type":45,"tag":81,"props":781,"children":782},{},[783,784,789],{"type":50,"value":245},{"type":45,"tag":87,"props":785,"children":787},{"className":786},[],[788],{"type":50,"value":141},{"type":50,"value":790}," when you need to launch, verify, or inspect logs\nfor the app after the visual update.",{"items":792,"total":910},[793,810,826,838,858,878,898],{"slug":794,"name":794,"fn":795,"description":796,"org":797,"tags":798,"stars":28,"repoUrl":29,"updatedAt":809},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[799,802,805,808],{"name":800,"slug":801,"type":15},"Accessibility","accessibility",{"name":803,"slug":804,"type":15},"Charts","charts",{"name":806,"slug":807,"type":15},"Data Visualization","data-visualization",{"name":26,"slug":27,"type":15},"2026-06-30T19:00:57.102",{"slug":811,"name":811,"fn":812,"description":813,"org":814,"tags":815,"stars":28,"repoUrl":29,"updatedAt":825},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[816,819,822],{"name":817,"slug":818,"type":15},"Agents","agents",{"name":820,"slug":821,"type":15},"Browser Automation","browser-automation",{"name":823,"slug":824,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":827,"name":827,"fn":828,"description":829,"org":830,"tags":831,"stars":28,"repoUrl":29,"updatedAt":837},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[832,833,836],{"name":820,"slug":821,"type":15},{"name":834,"slug":835,"type":15},"Local Development","local-development",{"name":823,"slug":824,"type":15},"2026-04-06T18:41:17.526867",{"slug":839,"name":839,"fn":840,"description":841,"org":842,"tags":843,"stars":28,"repoUrl":29,"updatedAt":857},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[844,845,848,851,854],{"name":817,"slug":818,"type":15},{"name":846,"slug":847,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":849,"slug":850,"type":15},"SDK","sdk",{"name":852,"slug":853,"type":15},"Serverless","serverless",{"name":855,"slug":856,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":859,"name":859,"fn":860,"description":861,"org":862,"tags":863,"stars":28,"repoUrl":29,"updatedAt":877},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[864,865,868,871,874],{"name":23,"slug":24,"type":15},{"name":866,"slug":867,"type":15},"React","react",{"name":869,"slug":870,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":872,"slug":873,"type":15},"UI Components","ui-components",{"name":875,"slug":876,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":879,"name":879,"fn":880,"description":881,"org":882,"tags":883,"stars":28,"repoUrl":29,"updatedAt":897},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[884,887,890,893,896],{"name":885,"slug":886,"type":15},"AI Infrastructure","ai-infrastructure",{"name":888,"slug":889,"type":15},"Cost Optimization","cost-optimization",{"name":891,"slug":892,"type":15},"LLM","llm",{"name":894,"slug":895,"type":15},"Performance","performance",{"name":875,"slug":876,"type":15},"2026-04-06T18:40:44.377464",{"slug":899,"name":899,"fn":900,"description":901,"org":902,"tags":903,"stars":28,"repoUrl":29,"updatedAt":909},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[904,905,908],{"name":888,"slug":889,"type":15},{"name":906,"slug":907,"type":15},"Database","database",{"name":891,"slug":892,"type":15},"2026-04-06T18:41:08.513425",600,{"items":912,"total":1107},[913,934,957,974,990,1007,1026,1038,1050,1064,1076,1091],{"slug":914,"name":914,"fn":915,"description":916,"org":917,"tags":918,"stars":931,"repoUrl":932,"updatedAt":933},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[919,922,925,928],{"name":920,"slug":921,"type":15},"Documents","documents",{"name":923,"slug":924,"type":15},"Healthcare","healthcare",{"name":926,"slug":927,"type":15},"Insurance","insurance",{"name":929,"slug":930,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":935,"name":935,"fn":936,"description":937,"org":938,"tags":939,"stars":954,"repoUrl":955,"updatedAt":956},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[940,943,945,948,951],{"name":941,"slug":942,"type":15},".NET","dotnet",{"name":944,"slug":935,"type":15},"ASP.NET Core",{"name":946,"slug":947,"type":15},"Blazor","blazor",{"name":949,"slug":950,"type":15},"C#","csharp",{"name":952,"slug":953,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":958,"name":958,"fn":959,"description":960,"org":961,"tags":962,"stars":954,"repoUrl":955,"updatedAt":973},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[963,966,969,972],{"name":964,"slug":965,"type":15},"Apps SDK","apps-sdk",{"name":967,"slug":968,"type":15},"ChatGPT","chatgpt",{"name":970,"slug":971,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":975,"name":975,"fn":976,"description":977,"org":978,"tags":979,"stars":954,"repoUrl":955,"updatedAt":989},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[980,983,986],{"name":981,"slug":982,"type":15},"API Development","api-development",{"name":984,"slug":985,"type":15},"CLI","cli",{"name":987,"slug":988,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":991,"name":991,"fn":992,"description":993,"org":994,"tags":995,"stars":954,"repoUrl":955,"updatedAt":1006},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[996,999,1002,1003],{"name":997,"slug":998,"type":15},"Cloudflare","cloudflare",{"name":1000,"slug":1001,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":846,"slug":847,"type":15},{"name":1004,"slug":1005,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":1008,"name":1008,"fn":1009,"description":1010,"org":1011,"tags":1012,"stars":954,"repoUrl":955,"updatedAt":1025},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1013,1016,1019,1022],{"name":1014,"slug":1015,"type":15},"Productivity","productivity",{"name":1017,"slug":1018,"type":15},"Project Management","project-management",{"name":1020,"slug":1021,"type":15},"Strategy","strategy",{"name":1023,"slug":1024,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":1027,"name":1027,"fn":1028,"description":1029,"org":1030,"tags":1031,"stars":954,"repoUrl":955,"updatedAt":1037},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1032,1033,1035,1036],{"name":26,"slug":27,"type":15},{"name":1034,"slug":1027,"type":15},"Figma",{"name":23,"slug":24,"type":15},{"name":970,"slug":971,"type":15},"2026-04-12T05:06:47.939943",{"slug":1039,"name":1039,"fn":1040,"description":1041,"org":1042,"tags":1043,"stars":954,"repoUrl":955,"updatedAt":1049},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1044,1045,1046,1047,1048],{"name":26,"slug":27,"type":15},{"name":20,"slug":21,"type":15},{"name":1034,"slug":1027,"type":15},{"name":23,"slug":24,"type":15},{"name":872,"slug":873,"type":15},"2026-05-10T05:59:52.971881",{"slug":1051,"name":1051,"fn":1052,"description":1053,"org":1054,"tags":1055,"stars":954,"repoUrl":955,"updatedAt":1063},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1056,1057,1058,1061,1062],{"name":26,"slug":27,"type":15},{"name":20,"slug":21,"type":15},{"name":1059,"slug":1060,"type":15},"Documentation","documentation",{"name":1034,"slug":1027,"type":15},{"name":23,"slug":24,"type":15},"2026-05-16T06:07:47.821474",{"slug":1065,"name":1065,"fn":1066,"description":1067,"org":1068,"tags":1069,"stars":954,"repoUrl":955,"updatedAt":1075},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1070,1071,1072,1073,1074],{"name":26,"slug":27,"type":15},{"name":1034,"slug":1027,"type":15},{"name":23,"slug":24,"type":15},{"name":872,"slug":873,"type":15},{"name":952,"slug":953,"type":15},"2026-05-16T06:07:40.583615",{"slug":1077,"name":1077,"fn":1078,"description":1079,"org":1080,"tags":1081,"stars":954,"repoUrl":955,"updatedAt":1090},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1082,1085,1086,1089],{"name":1083,"slug":1084,"type":15},"Animation","animation",{"name":987,"slug":988,"type":15},{"name":1087,"slug":1088,"type":15},"Creative","creative",{"name":26,"slug":27,"type":15},"2026-05-02T05:31:48.48485",{"slug":1092,"name":1092,"fn":1093,"description":1094,"org":1095,"tags":1096,"stars":954,"repoUrl":955,"updatedAt":1106},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1097,1098,1099,1102,1105],{"name":1087,"slug":1088,"type":15},{"name":26,"slug":27,"type":15},{"name":1100,"slug":1101,"type":15},"Image Generation","image-generation",{"name":1103,"slug":1104,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]