{"id":"fa055cb8-0f32-4e62-97bf-0ae1b36fc641","shortId":"NY8KYd","kind":"skill","title":"hig-platforms","tagline":">-","description":"# Apple HIG: Platform Design\n\nCheck for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.\n\n## Key Principles\n\n1. **Each platform has a distinct identity.** Do not port designs between platforms. Respect each platform's conventions, interaction models, and user expectations.\n\n2. **iOS: touch-first.** Direct manipulation on a handheld screen. Optimize for one-handed use. Navigation uses tab bars and push/pop stacks.\n\n3. **iPadOS: expanded canvas.** Support Split View, Slide Over, and Stage Manager. Use sidebars and multi-column layouts. Support pointer and keyboard alongside touch.\n\n4. **macOS: pointer and keyboard.** Dense information display is acceptable. Use menu bars, toolbars, and keyboard shortcuts extensively. Windows are resizable with precise control.\n\n5. **tvOS: remote and focus.** Viewed from a distance. Design for the Siri Remote with focus-based navigation. Large text, simple layouts, linear navigation.\n\n6. **visionOS: spatial interaction.** 3D environment using windows, volumes, and spaces. Eye tracking for targeting, indirect gestures for interaction. Respect ergonomic comfort zones.\n\n7. **watchOS: glanceable and brief.** Information consumable at a glance. Brief interactions. Digital Crown, haptics, and complications for timely content.\n\n8. **Games: own paradigm.** Free to define in-game interaction models, but still respect platform conventions for system interactions (notifications, accessibility, controllers).\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [designing-for-ios.md](references/designing-for-ios.md) | iOS | Touch, tab bars, navigation stacks, gestures, screen sizes, safe areas |\n| [designing-for-ipados.md](references/designing-for-ipados.md) | iPadOS | Multitasking, sidebars, pointer, keyboard, Apple Pencil, Stage Manager |\n| [designing-for-macos.md](references/designing-for-macos.md) | macOS | Menu bars, toolbars, window management, keyboard shortcuts, dense layouts, Dock |\n| [designing-for-tvos.md](references/designing-for-tvos.md) | tvOS | Focus engine, Siri Remote, lean-back experience, content-forward, parallax |\n| [designing-for-visionos.md](references/designing-for-visionos.md) | visionOS | Spatial computing, windows/volumes/spaces, eye tracking, hand gestures, depth |\n| [designing-for-watchos.md](references/designing-for-watchos.md) | watchOS | Glanceable UI, Digital Crown, complications, notifications, haptics |\n| [designing-for-games.md](references/designing-for-games.md) | Games | Controllers, immersive experiences, platform-specific conventions, accessibility |\n\n## Decision Framework\n\n1. **Identify the primary use context.** On the go (iOS/watchOS), at a desk (macOS), on the couch (tvOS), spatial environment (visionOS)?\n\n2. **Match input to interaction.** Touch for direct manipulation, pointer for precision, gaze+gesture for spatial, Digital Crown for quick scrolling, remote for focus navigation.\n\n3. **Adapt, don't replicate.** A macOS sidebar becomes a tab bar on iPhone. A visionOS volume has no equivalent on watchOS. Translate intent, not implementation.\n\n4. **Leverage platform strengths.** Live Activities on iOS, Desktop Widgets on macOS, complications on watchOS, immersive spaces on visionOS.\n\n5. **Maintain brand consistency** while respecting each platform's visual language and interaction patterns.\n\n## Output Format\n\n1. **Platform-specific recommendations** citing relevant HIG sections.\n2. **Platform differences table** comparing navigation, input, layout, and conventions.\n3. **Implementation notes** per platform including recommended APIs and adaptation strategies.\n\n## Questions to Ask\n\n1. Which platforms are you targeting?\n2. New app or adapting an existing one? If existing, which platform is the base?\n3. SwiftUI or UIKit/AppKit?\n4. Need to support older OS versions?\n5. Primary use context? (On the go, desk, couch, spatial, glanceable?)\n\n## Related Skills\n\n- **hig-foundations** -- Shared principles (color, typography, accessibility, layout) across platforms\n- **hig-patterns** -- Interaction patterns that manifest differently per platform\n- **hig-components-layout** -- Navigation structures (tab bars, sidebars, split views) that vary by platform\n- **hig-components-content** -- Content display that adapts across platforms\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","platforms","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code","cursor"],"capabilities":["skill","source-raintree-technology","skill-hig-platforms","topic-accessibility","topic-agent-skills","topic-ai-agents","topic-apple","topic-apple-design","topic-audit","topic-claude-code","topic-cursor","topic-hig","topic-ios","topic-macos","topic-skills"],"categories":["hig-doctor"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/raintree-technology/hig-doctor/hig-platforms","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add raintree-technology/hig-doctor","source_repo":"https://github.com/raintree-technology/hig-doctor","install_from":"skills.sh"}},"qualityScore":"0.472","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 45 github stars · SKILL.md body (4,475 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T00:57:10.007Z","embedding":null,"createdAt":"2026-04-18T22:18:12.211Z","updatedAt":"2026-05-02T00:57:10.007Z","lastSeenAt":"2026-05-02T00:57:10.007Z","tsv":"'1':27,306,413,446 '2':50,327,422,452 '3':74,352,432,467 '3d':152 '4':99,378,471 '5':123,397,478 '6':148 '7':171 '8':191 'accept':108 'access':212,303,498 'across':500,535 'activ':383 'adapt':353,441,456,534 'alongsid':97 'alreadi':23 'api':439 'app':454 'appl':4,240 'area':232 'ask':12,19,445 'back':266 'bar':70,111,225,248,363,519 'base':140,466 'becom':360 'brand':399 'brief':175,181 'built':537 'canva':77 'check':8 'cite':418 'claude/apple-design-context.md':10 'color':496 'column':91 'comfort':169 'compar':426 'complic':187,290,390 'compon':514,529 'comput':276 'consist':400 'consum':177 'content':190,219,269,530,531 'content-forward':268 'context':16,311,481 'control':122,213,296 'convent':44,207,302,431 'couch':322,486 'cover':24 'crown':184,289,344 'decis':304 'defin':197 'dens':104,254 'depth':282 'design':7,37,132 'designing-for-games.md':293 'designing-for-ios.md':220 'designing-for-ipados.md':233 'designing-for-macos.md':244 'designing-for-tvos.md':257 'designing-for-visionos.md':272 'designing-for-watchos.md':283 'desk':318,485 'desktop':386 'develop':543 'differ':424,509 'digit':183,288,343 'direct':55,334 'display':106,532 'distanc':131 'distinct':32 'dock':256 'engin':261 'environ':153,325 'equival':371 'ergonom':168 'exist':15,458,461 'expand':76 'expect':49 'experi':267,298 'extens':116 'eye':159,278 'first':54 'focus':127,139,260,350 'focus-bas':138 'format':412 'forward':270 'foundat':493 'framework':305 'free':195 'game':192,200,295 'gaze':339 'gestur':164,228,281,340 'glanc':180 'glanceabl':173,286,488 'go':314,484 'hand':65,280 'handheld':59 'haptic':185,292 'hig':2,5,420,492,503,513,528 'hig-components-cont':527 'hig-components-layout':512 'hig-found':491 'hig-pattern':502 'hig-platform':1 'ident':33 'identifi':307 'immers':297,393 'implement':377,433 'in-gam':198 'includ':437 'index':215 'indirect':163 'inform':21,105,176 'input':329,428 'intent':375 'interact':45,151,166,182,201,210,331,409,505 'io':51,222,385 'ios/watchos':315 'ipado':75,235 'iphon':365 'key':25,218 'keyboard':96,103,114,239,252 'languag':407 'larg':142 'layout':92,145,255,429,499,515 'lean':265 'lean-back':264 'leverag':379 'linear':146 'live':382 'maco':100,246,319,358,389 'maintain':398 'manag':85,243,251 'manifest':508 'manipul':56,335 'match':328 'menu':110,247 'model':46,202 'multi':90 'multi-column':89 'multitask':236 'navig':67,141,147,226,351,427,516 'need':472 'new':453 'note':434 'notif':211,291 'older':475 'one':64,459 'one-hand':63 'optim':61 'os':476 'output':411 'paradigm':194 'parallax':271 'pattern':410,504,506 'pencil':241 'per':435,510 'platform':3,6,29,39,42,206,300,380,404,415,423,436,448,463,501,511,526,536 'platform-specif':299,414 'pointer':94,101,238,336 'port':36 'precis':121,338 'primari':309,479 'principl':26,495 'push/pop':72 'question':13,443 'quick':346 'raintre':539 'raintree.technology':541,545 'recommend':417,438 'refer':214,216 'references/designing-for-games.md':294 'references/designing-for-ios.md':221 'references/designing-for-ipados.md':234 'references/designing-for-macos.md':245 'references/designing-for-tvos.md':258 'references/designing-for-visionos.md':273 'references/designing-for-watchos.md':284 'relat':489 'relev':419 'remot':125,136,263,348 'replic':356 'resiz':119 'respect':40,167,205,402 'safe':231 'screen':60,229 'scroll':347 'section':421 'share':494 'shortcut':115,253 'sidebar':87,237,359,520 'simpl':144 'siri':135,262 'size':230 'skill':490 'skill-hig-platforms' 'slide':81 'source-raintree-technology' 'space':158,394 'spatial':150,275,324,342,487 'specif':301,416 'split':79,521 'stack':73,227 'stage':84,242 'still':204 'strategi':442 'strength':381 'structur':517 'support':78,93,474 'swiftui':468 'system':209 'tab':69,224,362,518 'tabl':425 'target':162,451 'technolog':540 'text':143 'time':189 'tool':544 'toolbar':112,249 'topic':217 'topic-accessibility' 'topic-agent-skills' 'topic-ai-agents' 'topic-apple' 'topic-apple-design' 'topic-audit' 'topic-claude-code' 'topic-cursor' 'topic-hig' 'topic-ios' 'topic-macos' 'topic-skills' 'touch':53,98,223,332 'touch-first':52 'track':160,279 'translat':374 'tvos':124,259,323 'typographi':497 'ui':287 'uikit/appkit':470 'use':14,66,68,86,109,154,310,480 'user':48 'vari':524 'version':477 'view':80,128,522 'visiono':149,274,326,367,396 'visual':406 'volum':156,368 'watcho':172,285,373,392 'widget':387 'window':117,155,250 'windows/volumes/spaces':277 'zone':170","prices":[{"id":"cc4063eb-66ad-4745-b4d2-c41909f47b29","listingId":"fa055cb8-0f32-4e62-97bf-0ae1b36fc641","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"raintree-technology","category":"hig-doctor","install_from":"skills.sh"},"createdAt":"2026-04-18T22:18:12.211Z"}],"sources":[{"listingId":"fa055cb8-0f32-4e62-97bf-0ae1b36fc641","source":"github","sourceId":"raintree-technology/hig-doctor/hig-platforms","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-platforms","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:12.211Z","lastSeenAt":"2026-05-02T00:57:10.007Z"}],"details":{"listingId":"fa055cb8-0f32-4e62-97bf-0ae1b36fc641","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-platforms","github":{"repo":"raintree-technology/hig-doctor","stars":45,"topics":["accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code","cursor","hig","human-interface-guidelines","ios","macos","skills","swiftui","tvos","uikit","visionos","watchos"],"license":"other","html_url":"https://github.com/raintree-technology/hig-doctor","pushed_at":"2026-04-28T22:36:54Z","description":"Apple HIG audit CLI + 14 agent skills for AI coding assistants — score any project for HIG compliance across 12 frameworks","skill_md_sha":"ea4f5b29a922355ab1db07d7bf5eb50d7e10e2cf","skill_md_path":"skills/hig-platforms/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-platforms"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-platforms","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-platforms"},"updatedAt":"2026-05-02T00:57:10.007Z"}}