{"id":"fc0359ad-f9d6-466b-825c-2d929c09d82c","shortId":"fuPTmY","kind":"skill","title":"hig-components-status","tagline":">-","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\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\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 the status bar promptly** when exiting immersive contexts.\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)*","tags":["hig","components","status","doctor","raintree-technology","accessibility","agent-skills","ai-agents","apple","apple-design","audit","claude-code"],"capabilities":["skill","source-raintree-technology","skill-hig-components-status","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-status","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 (3,064 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.593Z","embedding":null,"createdAt":"2026-04-18T22:18:08.356Z","updatedAt":"2026-05-02T00:57:09.593Z","lastSeenAt":"2026-05-02T00:57:09.593Z","tsv":"'1':28,286,324 '10':179 '11':189 '12':208 '13':225 '14':236 '2':39,295,331 '3':65,305,334 '4':86,313,342 '5':99 '6':116 '7':133 '8':154 '9':168 'access':306 'across':318 'activ':190,230,277,380 'activity-rings.md':274 'adequ':166 'aggreg':122 'alreadi':24 'anim':240,298,302 'announc':309,386 'api':228 'app':349 'appear':105 'appl':5,223 'ar':153 'area':111,171,273 'ask':13,20,323 'associ':221 'bar':48,89,139,157,178,183,255,267 'behavior':317 'behind':175 'blue':217 'built':387 'celebr':237 'check':9 'claude/apple-design-context.md':11 'clear':52 'close':245 'color':211,283 'communic':73 'complet':238 'complic':359 'compon':3,8,355 'content':103,110,161,174,251 'context':17,188 'contrast':167 'convent':212 'cover':25 'dark':164 'data':207,231,382 'determin':40,92,258,292 'develop':393 'display':360 'distant':115 'download':59 'durat':68,262,300,327 'duration/percentage':42 'exercis':195,216 'exist':16 'exit':186 'experi':147 'faster':95 'feel':94 'fill':46 'fit':224,281 'format':285 'full':149 'full-screen':148 'game':152 'gestur':367 'give':49 'goal':198 'good':141 'green':215 'guidanc':299 'happen':76 'haptic':242 'healthkit':227,280,378 'hide':136,144 'hig':2,6,354,365,376 'hig-components-status':1 'hig-components-system':353 'hig-input':364 'hig-technolog':375 'immers':146,187 'in-app':347 'indetermin':66,259,294 'index':247 'indic':101,121,287,350 'info':269 'inform':22 'inlin':106,260 'input':366 'interact':173 'ios/ipados':265 'key':26,250 'known':44,328 'level':345 'light':162 'live':310 'long':336 'longer':33 'manual':234 'match':155 'measur':63 'media':151 'metaphor':204 'modal':113 'move':194,214 'move/exercise/stand':279 'multipl':120 'near':108 'network':84 'one':126 'oper':32,124,339 'output':284 'place':100 'placement':261 'platform':315,320,333 'platform-specif':314 'prefer':87 'principl':27 'process':64 'progress':30,47,88,93,107,254,308,361,369,385 'progress-indicators.md':252 'promis':78 'prompt':184 'pull':372 'pull-to-refresh':371 'question':14,321 'raintre':389 'raintree.technology':391,395 'rather':232 'rational':291 'reason':142 'recommend':289 'red':213 'refer':246,248 'references/activity-rings.md':275 'references/progress-indicators.md':253 'references/status-bars.md':264 'refresh':374 'region':311 'relat':351 'relev':132 'remain':55 'represent':127 'repurpos':201 'request':85 'reserv':143 'respect':169,209 'restor':180 'ring':191,203,210,244,278,381 'safe':170,272 'screen':150 'second':36 'sens':53 'show':29,129 'simultan':123 'skill':352 'skill-hig-components-status' 'source-raintree-technology' 'specif':316 'spinner':72,91,257 'stack':119 'stand':197,218 'state':370 'status':4,7,138,156,177,182,266,363 'status-bars.md':263 'strong':220 'style':158,271,303 'system':268,344,356 'system-level':343 'take':341 'target':319 'technolog':377,390 'threshold':301 'time':296 'timefram':80 'tool':394 'topic':249 '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' 'track':235,282 'transit':304 'trigger':368 'trustworthi':98 'two':38 'type':288 'typic':340 'unknown':70,330 'unpredict':83 'unrel':206 'updat':312 'upload':60 'use':15,57,81,226 'user':50 'visibl':270 'voiceov':307,383 'vs':293 'watcho':276 'widget':357 'without':77,140 'work':56,74","prices":[{"id":"2c6a069c-2ce1-460d-81b5-ae4ec0f3f096","listingId":"fc0359ad-f9d6-466b-825c-2d929c09d82c","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:08.356Z"}],"sources":[{"listingId":"fc0359ad-f9d6-466b-825c-2d929c09d82c","source":"github","sourceId":"raintree-technology/hig-doctor/hig-components-status","sourceUrl":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-status","isPrimary":false,"firstSeenAt":"2026-04-18T22:18:08.356Z","lastSeenAt":"2026-05-02T00:57:09.593Z"}],"details":{"listingId":"fc0359ad-f9d6-466b-825c-2d929c09d82c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"raintree-technology","slug":"hig-components-status","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":"af29a3c3e260966129e7bfa13ab1a8f36a5a49e2","skill_md_path":"skills/hig-components-status/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-status"},"layout":"multi","source":"github","category":"hig-doctor","frontmatter":{"name":"hig-components-status","description":">-"},"skills_sh_url":"https://skills.sh/raintree-technology/hig-doctor/hig-components-status"},"updatedAt":"2026-05-02T00:57:09.593Z"}}