{"id":"43d9ac86-068c-4a6e-b3df-25868f6db8c9","shortId":"KdQqkb","kind":"skill","title":"hig-components-system","tagline":"Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.","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\n### General\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\n### Widgets\n\n3. **Show relevant information, not everything.** Display the most useful subset, updated appropriately.\n\n4. **Support multiple 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\n### Live Activities\n\n6. **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\n### Notifications\n\n8. **Respect user attention.** Only send notifications for information users genuinely care about. No promotional or low-value notifications.\n\n9. **Actionable and self-contained.** Include enough context to understand and act without opening the app. Support notification actions. Use threading and grouping.\n\n### Complications\n\n10. **Focused data on the watch face.** Design for the smallest useful representation. Support multiple families. Budget updates wisely.\n\n### Home Screen Quick Actions\n\n11. **3-4 most common tasks.** Short titles, optional subtitles, relevant SF Symbol icons.\n\n### Top Shelf\n\n12. **tvOS showcase.** Feature content that entices: new episodes, featured items, recent content.\n\n### App Clips\n\n13. **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\n### App Shortcuts\n\n14. **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)*\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["hig","components","system","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-hig-components-system","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-components-system","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34768 github stars · SKILL.md body (4,642 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-04-23T18:51:27.310Z","embedding":null,"createdAt":"2026-04-18T21:38:30.788Z","updatedAt":"2026-04-23T18:51:27.310Z","lastSeenAt":"2026-04-23T18:51:27.310Z","tsv":"'-4':268 '1':54,433,485 '10':243 '11':266 '12':282 '13':297 '14':327 '2':81,444,494 '3':108,267,454,497 '4':121,463,504 '5':141,473 '6':161 '7':182 '8':198 '9':218 'act':230 'action':20,219,237,265,330,376,391,571 'activ':14,160,363,523 'adapt':472 'alreadi':49 'anoth':140 'app':25,28,62,75,155,234,295,309,323,325,407,425,493,541,548 'app-clips.md':405 'app-shortcuts.md':423 'appl':5,30 'applic':565 'appropri':120 'ask':38,45,484,609 'attent':80,201,375 'behavior':476 'best':439 'boundari':617 'bring':60 'budget':259,305,386,461 'built':550 'care':209 'case':443 'check':34 'clarif':611 'claude/apple-design-context.md':36 'clear':166,584 'clip':26,296,408,549 'common':270,394 'complic':16,98,242,381,420,535,545 'complications.md':379 'compon':3,11,515 'conclud':196 'constraint':91,462 'contain':223 'content':66,152,286,294,350,378,403,445 'context':42,84,226 'convers':342 'cover':50 'criteria':620 'crown':533 'custom':419 'data':188,245,384,502 'deep':143,357,474 'deep-link':142 'defin':335 'deliveri':170 'describ':572,588 'design':76,134,174,250 'develop':556 'differ':90 'digit':532 'display':114,449 'distinct':126 'download':311 'dynam':177,368 'end':169,191 'enough':225 'entic':288 'environ':600 'environment-specif':599 'episod':290 'event':163,195 'everyth':113 'execut':567 'exist':41 'experi':10,33,59,435,531 'expert':605 'face':24,249,383,418,421 'famili':258,385 'far':100 'featur':285,291,402 'fit':440 'focus':244,299,412 'format':432 'frequenc':456 'frequent':338,499 'full':322 'function':300 'general':53 'genuin':208 'glanceabl':55,354,509 'group':241,377 'guidanc':7 'haptic':392 'healthkit':543 'hig':2,6,31,514,525,537 'hig-components-status':513 'hig-components-system':1 'hig-input':524 'hig-technolog':536 'home':17,94,262 'home-screen-quick-actions.md':388 'icon':279 'immedi':56,318 'import':65 'includ':224,459 'index':346 'indic':518 'info':355 'inform':47,111,206,487 'input':526,614 'instal':324 'instant':298,409 'interact':527 'island':178,369 'item':106,292 'key':51,329,349 'launch':73 'layout':127,471 'lightweight':411 'limit':576 'link':144,358,475 'live':13,159,362,522 'live-activities.md':360 'load':306 'lock':86,180,370 'low':215 'low-valu':214 'match':585 'miss':622 'multipl':123,257 'natur':341 'need':315,488,510 'new':289 'nfc':546 'nfc/qr':414 'notif':15,197,204,217,236,374 'notifications.md':372 'offer':321 'omit':453 'open':232 'option':274 'output':431,594 'outsid':491 'overview':575 'pattern':528 'permiss':615 'phrase':344 'platform':83,496 'primari':508 'principl':52 'prioriti':450 'progress':517 'promot':212 'prompt':192 'question':39,482 'quick':19,264,307,390 'raintre':552 'raintree.technology':554,558 'rate':458 'real':365 'real-tim':364 'recent':293 'recommend':436 'refer':345,347 'references/app-clips.md':406 'references/app-shortcuts.md':424 'references/complications.md':380 'references/home-screen-quick-actions.md':389 'references/live-activities.md':361 'references/notifications.md':373 'references/top-shelf.md':399 'references/watch-faces.md':416 'references/widgets.md':352 'refresh':457 'relat':511 'relev':110,151,276 'represent':255 'requir':613 'respect':82,199 'review':606 'ride':173 'root':157 'safeti':616 'scale':137 'scope':587 'score':171 'screen':18,87,95,158,181,263,371 'second':78 'see':71 'self':222 'self-contain':221 'send':203 'sf':277,396 'share':422 'shelf':22,105,281,401 'short':272 'shortcut':29,326,336,426,542 'show':109 'showcas':284,404 'siri':332,427,539 'size':124,129,304,356 'size/family':464 'skill':512,563,579 'skill-hig-components-system' 'smaller':101 'smallest':253 'source-sickn33' 'specif':601 'spotlight':334,428 'stale':187 'start':167 'status':516 'stay':183 'stop':607 'store':310 'strategi':446 'strict':303 'subset':118 'substitut':597 'subtitl':275 'success':619 'support':122,235,256,468 'surfac':68,328,438,490 'symbol':278,397 'system':4,9,32,58,434,460,530 'take':147,479 'tap':146,478 'task':271,319,339,395,413,583 'technolog':538,553 'test':603 'thought':133 'thread':239 'time':186,366 'timelin':359 'timer':172 'titl':273 'tool':557 'top':21,104,280,400 'top-shelf.md':398 'topic':348 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'touch':393 'track':162,367 'treat':592 'trigger':343,430 'trust':190 'tvos':283 'undermin':189 'understand':228 'updat':119,184,260,387,455,503 'use':40,117,238,254,340,410,442,561,577 'user':70,148,200,207,481 'valid':602 'valu':57,216 'variant':465 'version':138 'voic':429 'watch':23,248,382,417 'watch-faces.md':415 'widget':12,88,96,107,353,520 'widgets.md':351 'wise':261 'within':301 'without':72,231,308 'workflow':569","prices":[{"id":"657fafc1-213b-42bb-b40a-a90b38cbf276","listingId":"43d9ac86-068c-4a6e-b3df-25868f6db8c9","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:38:30.788Z"}],"sources":[{"listingId":"43d9ac86-068c-4a6e-b3df-25868f6db8c9","source":"github","sourceId":"sickn33/antigravity-awesome-skills/hig-components-system","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-system","isPrimary":false,"firstSeenAt":"2026-04-18T21:38:30.788Z","lastSeenAt":"2026-04-23T18:51:27.310Z"}],"details":{"listingId":"43d9ac86-068c-4a6e-b3df-25868f6db8c9","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"hig-components-system","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34768,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-23T06:41:03Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"cc9c6076f9af2c6a38e072acc33ceaf4763861f8","skill_md_path":"skills/hig-components-system/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-system"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"hig-components-system","description":"Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-components-system"},"updatedAt":"2026-04-23T18:51:27.310Z"}}