{"id":"81641866-fa26-495d-83b6-5a2fec875149","shortId":"3cv7ha","kind":"skill","title":"hig-components-system","tagline":">-","description":"# Apple HIG: System Experiences\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. **Glanceable, immediate value.** System experiences bring your app's most important content to surfaces the user sees without launching your app. Design for seconds of attention.\n\n2. **Respect platform context.** A Lock Screen widget has different constraints than a Home Screen widget. A complication is far smaller than a top shelf item.\n\n3. **Widgets: show relevant information, not everything.** Display the most useful subset, updated appropriately.\n\n4. **Support multiple widget sizes with distinct layouts.** Each size should be a thoughtful design, not a scaled version of another.\n\n5. **Deep-link on tap.** Take users to the relevant content, not the app's root screen.\n\n6. **Live Activities: track events with a clear start and end.** Deliveries, scores, timers, rides. Design for both Dynamic Island and Lock Screen.\n\n7. **Stay updated and timely.** Stale data undermines trust. End promptly when the event concludes.\n\n8. **Respect user attention with notifications.** Only send notifications for information users genuinely care about. No promotional or low-value notifications.\n\n9. **Notifications: actionable and self-contained.** Include enough context to understand and act without opening the app. Support notification actions. Use threading and grouping.\n\n10. **Complications: focused data on the watch face.** Design for the smallest useful representation. Support multiple families. Budget updates wisely.\n\n11. **Home Screen quick actions: 3-4 most common tasks.** Short titles, optional subtitles, relevant SF Symbol icons.\n\n12. **Top Shelf: tvOS showcase.** Feature content that entices: new episodes, featured items, recent content.\n\n13. **App Clips: instant, focused functionality within a strict size budget.** Load quickly without App Store download. Only what's needed for the immediate task, then offer full app install.\n\n14. **App Shortcuts: surface key actions to Siri and Spotlight.** Define shortcuts for frequent tasks. Use natural, conversational trigger phrases.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [widgets.md](references/widgets.md) | Widgets | Glanceable info, sizes, deep linking, timeline |\n| [live-activities.md](references/live-activities.md) | Live Activities | Real-time tracking, Dynamic Island, Lock Screen |\n| [notifications.md](references/notifications.md) | Notifications | Attention, actions, grouping, content |\n| [complications.md](references/complications.md) | Complications | Watch face data, families, budgeted updates |\n| [home-screen-quick-actions.md](references/home-screen-quick-actions.md) | Quick actions | Haptic Touch, common tasks, SF Symbols |\n| [top-shelf.md](references/top-shelf.md) | Top shelf | Featured content, showcase |\n| [app-clips.md](references/app-clips.md) | App Clips | Instant use, lightweight, focused task, NFC/QR |\n| [watch-faces.md](references/watch-faces.md) | Watch faces | Custom complications, face sharing |\n| [app-shortcuts.md](references/app-shortcuts.md) | App Shortcuts | Siri, Spotlight, voice triggers |\n\n## Output Format\n\n1. **System experience recommendation** -- which surface best fits the use case.\n2. **Content strategy** -- what to display, priority, what to omit.\n3. **Update frequency** -- refresh rate including system budget constraints.\n4. **Size/family variants** -- which to support and how layout adapts.\n5. **Deep link behavior** -- where tapping takes the user.\n\n## Questions to Ask\n\n1. What information needs to surface outside the app?\n2. Which platform?\n3. How frequently does the data update?\n4. What is the primary glanceable need?\n\n## Related Skills\n\n- **hig-components-status** -- Progress indicators in widgets or Live Activities\n- **hig-inputs** -- Interaction patterns for system experiences (Digital Crown for complications)\n- **hig-technologies** -- Siri for App Shortcuts, HealthKit for complications, NFC for App Clips\n\n---\n\n*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*","tags":["hig","components","system","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code"],"capabilities":["skill","source-raintree-technology","skill-hig-components-system","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-components-system","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,201 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:09.681Z","embedding":null,"createdAt":"2026-04-18T22:18:09.144Z","updatedAt":"2026-05-02T00:57:09.681Z","lastSeenAt":"2026-05-02T00:57:09.681Z","tsv":"'-4':245 '1':28,410,462 '10':219 '11':239 '12':257 '13':272 '14':302 '2':55,421,471 '3':81,244,431,474 '4':95,440,481 '5':116,450 '6':134 '7':157 '8':172 '9':194 'act':207 'action':196,214,243,307,353,368 'activ':136,340,500 'adapt':449 'alreadi':24 'anoth':115 'app':36,49,130,211,273,286,300,303,384,402,470,518,525 'app-clips.md':382 'app-shortcuts.md':400 'appl':5 'appropri':94 'ask':13,20,461 'attent':54,175,352 'behavior':453 'best':416 'bring':34 'budget':236,282,363,438 'built':527 'care':185 'case':420 'check':9 'claude/apple-design-context.md':11 'clear':141 'clip':274,385,526 'common':247,371 'complic':72,220,358,397,512,522 'complications.md':356 'compon':3,492 'conclud':171 'constraint':65,439 'contain':200 'content':40,127,263,271,327,355,380,422 'context':17,58,203 'convers':319 'cover':25 'crown':510 'custom':396 'data':163,222,361,479 'deep':118,334,451 'deep-link':117 'defin':312 'deliveri':145 'design':50,109,149,227 'develop':533 'differ':64 'digit':509 'display':88,426 'distinct':101 'download':288 'dynam':152,345 'end':144,166 'enough':202 'entic':265 'episod':267 'event':138,170 'everyth':87 'exist':16 'experi':8,33,412,508 'face':226,360,395,398 'famili':235,362 'far':74 'featur':262,268,379 'fit':417 'focus':221,276,389 'format':409 'frequenc':433 'frequent':315,476 'full':299 'function':277 'genuin':184 'glanceabl':29,331,486 'group':218,354 'haptic':369 'healthkit':520 'hig':2,6,491,502,514 'hig-components-status':490 'hig-components-system':1 'hig-input':501 'hig-technolog':513 'home':68,240 'home-screen-quick-actions.md':365 'icon':256 'immedi':30,295 'import':39 'includ':201,436 'index':323 'indic':495 'info':332 'inform':22,85,182,464 'input':503 'instal':301 'instant':275,386 'interact':504 'island':153,346 'item':80,269 'key':26,306,326 'launch':47 'layout':102,448 'lightweight':388 'link':119,335,452 'live':135,339,499 'live-activities.md':337 'load':283 'lock':60,155,347 'low':191 'low-valu':190 'multipl':97,234 'natur':318 'need':292,465,487 'new':266 'nfc':523 'nfc/qr':391 'notif':177,180,193,195,213,351 'notifications.md':349 'offer':298 'omit':430 'open':209 'option':251 'output':408 'outsid':468 'pattern':505 'phrase':321 'platform':57,473 'primari':485 'principl':27 'prioriti':427 'progress':494 'promot':188 'prompt':167 'question':14,459 'quick':242,284,367 'raintre':529 'raintree.technology':531,535 'rate':435 'real':342 'real-tim':341 'recent':270 'recommend':413 'refer':322,324 'references/app-clips.md':383 'references/app-shortcuts.md':401 'references/complications.md':357 'references/home-screen-quick-actions.md':366 'references/live-activities.md':338 'references/notifications.md':350 'references/top-shelf.md':376 'references/watch-faces.md':393 'references/widgets.md':329 'refresh':434 'relat':488 'relev':84,126,253 'represent':232 'respect':56,173 'ride':148 'root':132 'scale':112 'score':146 'screen':61,69,133,156,241,348 'second':52 'see':45 'self':199 'self-contain':198 'send':179 'sf':254,373 'share':399 'shelf':79,259,378 'short':249 'shortcut':304,313,403,519 'show':83 'showcas':261,381 'siri':309,404,516 'size':99,104,281,333 'size/family':441 'skill':489 'skill-hig-components-system' 'smaller':75 'smallest':230 'source-raintree-technology' 'spotlight':311,405 'stale':162 'start':142 'status':493 'stay':158 'store':287 'strategi':423 'strict':280 'subset':92 'subtitl':252 'support':96,212,233,445 'surfac':42,305,415,467 'symbol':255,374 'system':4,7,32,411,437,507 'take':122,456 'tap':121,455 'task':248,296,316,372,390 'technolog':515,530 'thought':108 'thread':216 'time':161,343 'timelin':336 'timer':147 'titl':250 'tool':534 'top':78,258,377 'top-shelf.md':375 'topic':325 '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':370 'track':137,344 'trigger':320,407 'trust':165 'tvos':260 'undermin':164 'understand':205 'updat':93,159,237,364,432,480 'use':15,91,215,231,317,387,419 'user':44,123,174,183,458 'valu':31,192 'variant':442 'version':113 'voic':406 'watch':225,359,394 'watch-faces.md':392 'widget':62,70,82,98,330,497 'widgets.md':328 'wise':238 'within':278 'without':46,208,285","prices":[{"id":"5ffbbec3-ed03-4c58-bed4-424af106b845","listingId":"81641866-fa26-495d-83b6-5a2fec875149","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:09.144Z"}],"sources":[{"listingId":"81641866-fa26-495d-83b6-5a2fec875149","source":"github","sourceId":"raintree-technology/hig-doctor/hig-components-system","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-system","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:09.144Z","lastSeenAt":"2026-05-02T00:57:09.681Z"}],"details":{"listingId":"81641866-fa26-495d-83b6-5a2fec875149","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-components-system","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":"75edebd0ca3a69b72073a9c6e3ce453c43d3c9db","skill_md_path":"skills/hig-components-system/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-system"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-components-system","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-components-system"},"updatedAt":"2026-05-02T00:57:09.681Z"}}