{"id":"a45a4daa-ee55-401d-bc19-27f9525be660","shortId":"SPzz8U","kind":"skill","title":"hig-components-status","tagline":"Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.","description":"# Apple HIG: Status Components\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### Progress Indicators\n\n1. **Show progress for operations longer than a second or two.**\n\n2. **Determinate when duration/percentage is known.** A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process.\n\n3. **Indeterminate when duration is unknown.** A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.\n\n4. **Prefer progress bars over spinners.** Determinate progress feels faster and more trustworthy.\n\n5. **Place indicators where content will appear.** Inline progress near the content area, not modal or distant.\n\n6. **Don't stack multiple indicators.** Aggregate simultaneous operations into one representation or show the most relevant.\n\n### Status Bars\n\n7. **Don't hide the status bar without good reason.** Reserve hiding for immersive experiences (full-screen media, games, AR).\n\n8. **Match status bar style to your content.** Light or dark for adequate contrast.\n\n9. **Respect safe areas.** No interactive content behind the status bar.\n\n10. **Restore promptly** when exiting immersive contexts.\n\n### Activity Rings\n\n11. **Activity rings are for Move, Exercise, and Stand goals.** Don't repurpose the ring metaphor for unrelated data.\n\n12. **Respect ring color conventions.** Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.\n\n13. **Use HealthKit APIs** for activity data rather than manual tracking.\n\n14. **Celebrate completions** with animation and haptics when rings close.\n\n## Reference Index\n\n| Reference | Topic | Key content |\n|---|---|---|\n| [progress-indicators.md](references/progress-indicators.md) | Progress bars and spinners | Determinate, indeterminate, inline placement, duration |\n| [status-bars.md](references/status-bars.md) | iOS/iPadOS status bar | System info, visibility, style, safe areas |\n| [activity-rings.md](references/activity-rings.md) | watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color |\n\n## Output Format\n\n1. **Indicator type recommendation** with rationale (determinate vs indeterminate).\n2. **Timing and animation guidance** -- duration thresholds, animation style, transitions.\n3. **Accessibility** -- VoiceOver progress announcements, live region updates.\n4. **Platform-specific behavior** across targeted platforms.\n\n## Questions to Ask\n\n1. Is the duration known or unknown?\n2. Which platforms?\n3. How long does the operation typically take?\n4. System-level or in-app indicator?\n\n## Related Skills\n\n- **hig-components-system** -- Widgets and complications displaying progress or status\n- **hig-inputs** -- Gestures triggering progress states (pull-to-refresh)\n- **hig-technologies** -- HealthKit for activity ring data; VoiceOver for progress announcements\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","status","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-hig-components-status","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-status","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 (3,533 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.209Z","embedding":null,"createdAt":"2026-04-18T21:38:30.026Z","updatedAt":"2026-04-23T18:51:27.209Z","lastSeenAt":"2026-04-23T18:51:27.209Z","tsv":"'1':47,306,344 '10':200 '11':209 '12':228 '13':245 '14':256 '2':58,315,351 '3':84,325,354 '4':105,333,362 '5':118 '6':135 '7':154 '8':175 '9':189 'access':326 'across':338 'action':428 'activ':20,207,210,250,297,400 'activity-rings.md':294 'adequ':187 'aggreg':141 'alreadi':41 'anim':260,318,322 'announc':329,406 'api':248 'app':369 'appear':124 'appl':5,22,243 'applic':422 'ar':174 'area':130,192,293 'ask':30,37,343,466 'associ':241 'bar':18,67,108,153,160,178,199,275,287 'behavior':337 'behind':196 'blue':237 'boundari':474 'built':407 'celebr':257 'check':26 'clarif':468 'claude/apple-design-context.md':28 'clear':71,441 'close':265 'color':231,303 'communic':92 'complet':258 'complic':379 'compon':3,13,25,375 'content':122,129,182,195,271 'context':34,206 'contrast':188 'convent':232 'cover':42 'criteria':477 'dark':185 'data':227,251,402 'describ':429,445 'determin':59,111,278,312 'develop':413 'display':380 'distant':134 'download':78 'durat':87,282,320,347 'duration/percentage':61 'environ':457 'environment-specif':456 'execut':424 'exercis':215,236 'exist':33 'exit':204 'experi':168 'expert':462 'faster':114 'feel':113 'fill':65 'fit':244,301 'format':305 'full':170 'full-screen':169 'game':173 'gestur':387 'give':68 'goal':218 'good':162 'green':235 'guidanc':7,319 'happen':95 'haptic':262 'healthkit':247,300,398 'hide':157,165 'hig':2,6,23,374,385,396 'hig-components-status':1 'hig-components-system':373 'hig-input':384 'hig-technolog':395 'immers':167,205 'in-app':367 'includ':14 'indetermin':85,279,314 'index':267 'indic':16,46,120,140,307,370 'info':289 'inform':39 'inlin':125,280 'input':386,471 'interact':194 'ios/ipados':285 'key':43,270 'known':63,348 'level':365 'light':183 'limit':433 'live':330 'long':356 'longer':52 'manual':254 'match':176,442 'measur':82 'media':172 'metaphor':224 'miss':479 'modal':132 'move':214,234 'move/exercise/stand':299 'multipl':139 'near':127 'network':103 'one':145 'oper':51,143,359 'output':304,451 'overview':432 'permiss':472 'place':119 'placement':281 'platform':335,340,353 'platform-specif':334 'prefer':106 'principl':44 'process':83 'progress':11,15,45,49,66,107,112,126,274,328,381,389,405 'progress-indicators.md':272 'promis':97 'prompt':202 'pull':392 'pull-to-refresh':391 'question':31,341 'raintre':409 'raintree.technology':411,415 'rather':252 'rational':311 'reason':163 'recommend':309 'red':233 'refer':266,268 'references/activity-rings.md':295 'references/progress-indicators.md':273 'references/status-bars.md':284 'refresh':394 'region':331 'relat':371 'relev':151 'remain':74 'represent':146 'repurpos':221 'request':104 'requir':470 'reserv':164 'respect':190,229 'restor':201 'review':463 'ring':21,208,211,223,230,264,298,401 'safe':191,292 'safeti':473 'scope':444 'screen':171 'second':55 'sens':72 'show':48,148 'simultan':142 'skill':372,420,436 'skill-hig-components-status' 'source-sickn33' 'specif':336,458 'spinner':91,110,277 'stack':138 'stand':217,238 'state':390 'status':4,9,17,24,152,159,177,198,286,383 'status-bars.md':283 'stop':464 'strong':240 'style':179,291,323 'substitut':454 'success':476 'system':288,364,376 'system-level':363 'take':361 'target':339 'task':440 'technolog':397,410 'test':460 'threshold':321 'time':316 'timefram':99 'tool':414 'topic':269 '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' 'track':255,302 'transit':324 'treat':449 'trigger':388 'trustworthi':117 'two':57 'type':308 'typic':360 'ui':12 'unknown':89,350 'unpredict':102 'unrel':226 'updat':332 'upload':79 'use':32,76,100,246,418,434 'user':69 'valid':459 'visibl':290 'voiceov':327,403 'vs':313 'watcho':296 'widget':377 'without':96,161 'work':75,93 'workflow':426","prices":[{"id":"11cfbf28-513c-4f05-bdfa-8081687f0d70","listingId":"a45a4daa-ee55-401d-bc19-27f9525be660","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.026Z"}],"sources":[{"listingId":"a45a4daa-ee55-401d-bc19-27f9525be660","source":"github","sourceId":"sickn33/antigravity-awesome-skills/hig-components-status","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-status","isPrimary":false,"firstSeenAt":"2026-04-18T21:38:30.026Z","lastSeenAt":"2026-04-23T18:51:27.209Z"}],"details":{"listingId":"a45a4daa-ee55-401d-bc19-27f9525be660","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"hig-components-status","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":"f76f98508ad37417b6a4554f788484075296af12","skill_md_path":"skills/hig-components-status/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-status"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"hig-components-status","description":"Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/hig-components-status"},"updatedAt":"2026-04-23T18:51:27.209Z"}}