Agent skill

Hig Components Status

by raintree-technology in raintree-technology/hig-doctor

Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.

MITAuto-check passedMobile

Install Hig Components Status

skills CLI
$ npx skills add raintree-technology/hig-doctor --skill hig-components-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install raintree-technology/hig-doctor hig-components-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/raintree-technology/hig-doctor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hig-components-status .claude/skills/hig-components-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hig-components-status
GitHub stars
143
Used in
5 other repos
Token cost
~963 tokens
SKILL.md length
365 words
Files
4 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.

  • Works in 12 steps: Show progress for operations longer than… → Determinate when duration/percentage is… → Indeterminate when duration is unknown.… → …
  • Asked about: progress indicator
  • SKILL.md covers Key Principles, Reference Index, Output Format and Questions to Ask, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hig Components Status is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use this skill when asked about: "progress indicator", "progress bar", "loading spinner", "status bar", "activity ring", "progress display", determinate vs indeterminate progress, loading states, or fitness tracking rings. Also use when the user says "how do I show loading state," "should I use a spinner or progress bar," "what goes in the status bar," or asks about activity indicators…

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/activity-rings.md`, `references/progress-indicators.md` and `references/status-bars.md`).

It sits in Mobile, covering iOS development and Data pipelines and ETL. It works with iOS. The repository describes itself as: Apple HIG reference and cross-framework UI audit tooling for agents. The licence is MIT.

When your agent uses it

  • Asked about: progress indicator
  • Loading spinner
  • Progress display
  • Determinate vs indeterminate progress

Example prompts

  • “progress indicator”
  • “progress bar”
  • “loading spinner”
  • “/hig-components-status”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Show progress for operations longer than a second or two.
  2. Determinate when duration/percentage is known. A filling progress bar gives users a clear sense of remaining work. Use for downloads…
  3. Indeterminate when duration is unknown. A spinner communicates work is happening without promising a timeframe. Use for unpredictable…
  4. Prefer progress bars over spinners. Determinate progress feels faster and more trustworthy.
  5. Place indicators where content will appear. Inline progress near the content area, not modal or distant.
  6. Don't stack multiple indicators. Aggregate simultaneous operations into one representation or show the most relevant.
  7. Don't hide the status bar without good reason. Reserve hiding for immersive experiences (full-screen media, games, AR).
  8. Match status bar style to your content. Light or dark for adequate contrast.
  9. Respect safe areas. No interactive content behind the status bar.
  10. Restore the status bar promptly when exiting immersive contexts.
  11. Activity rings are for Move, Exercise, and Stand goals. Don't repurpose the ring metaphor for unrelated data.
  12. Respect ring color conventions. Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.

What it can do on your machine

Read from SKILL.md and the folder at commit 3ec08f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • raintree.technology

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hig Components Status loads about 963 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 180 tokens; SKILL.md has 365 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~180
When it runs · the whole SKILL.md, loaded when a task matches
~963
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from raintree-technology/hig-doctor at commit 3ec08f5, republished under its MIT licence (© raintree-technology). 365 words, ~963 tokens.

Download SKILL.mdSave it as .claude/skills/hig-components-status/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
hig-components-status
description
Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use this skill when asked about: "progress indicator", "progress bar", "loading spinner", "status bar", "activity ring", "progress display", determinate vs indeterminate progress, loading states, or fitness tracking rings. Also use when the user says "how do I show loading state," "should I use a spinner or progress bar," "what goes in the status bar," or asks about activity indicators. Cross-references: hig-components-system for widgets and complications, hig-inputs for gesture-driven progress controls, hig-technologies for HealthKit and activity ring data integration.
version
1.0.0

Apple HIG: Status Components

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Key Principles

  1. Show progress for operations longer than a second or two.

  2. 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.

  3. Indeterminate when duration is unknown. A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.

  4. Prefer progress bars over spinners. Determinate progress feels faster and more trustworthy.

  5. Place indicators where content will appear. Inline progress near the content area, not modal or distant.

  6. Don't stack multiple indicators. Aggregate simultaneous operations into one representation or show the most relevant.

  7. Don't hide the status bar without good reason. Reserve hiding for immersive experiences (full-screen media, games, AR).

  8. Match status bar style to your content. Light or dark for adequate contrast.

  9. Respect safe areas. No interactive content behind the status bar.

  10. Restore the status bar promptly when exiting immersive contexts.

  11. Activity rings are for Move, Exercise, and Stand goals. Don't repurpose the ring metaphor for unrelated data.

  12. Respect ring color conventions. Red (Move), green (Exercise), blue (Stand) are strongly associated with Apple Fitness.

  13. Use HealthKit APIs for activity data rather than manual tracking.

  14. Celebrate completions with animation and haptics when rings close.

Show full SKILL.md (129 more words)Show less

Reference Index

ReferenceTopicKey content
progress-indicators.mdProgress bars and spinnersDeterminate, indeterminate, inline placement, duration
status-bars.mdiOS/iPadOS status barSystem info, visibility, style, safe areas
activity-rings.mdwatchOS activity ringsMove/Exercise/Stand, HealthKit, fitness tracking, color

Output Format

  1. Indicator type recommendation with rationale (determinate vs indeterminate).
  2. Timing and animation guidance -- duration thresholds, animation style, transitions.
  3. Accessibility -- VoiceOver progress announcements, live region updates.
  4. Platform-specific behavior across targeted platforms.

Questions to Ask

  1. Is the duration known or unknown?
  2. Which platforms?
  3. How long does the operation typically take?
  4. System-level or in-app indicator?
  • hig-components-system -- Widgets and complications displaying progress or status
  • hig-inputs -- Gestures triggering progress states (pull-to-refresh)
  • hig-technologies -- HealthKit for activity ring data; VoiceOver for progress announcements

Built by Raintree Technology · More developer tools

© raintree-technology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/hig-components-status of raintree-technology/hig-doctor.

  • SKILL.md
  • references/activity-rings.md
  • references/progress-indicators.md
  • references/status-bars.md

Open the folder on GitHubat commit 3ec08f5

Used in 5 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in raintree-technology/hig-doctor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hig Components Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hig Components Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hig Components Status this skillraintree-technology/hig-doctor1435 repos~963Automated safety check: PassMIT
iOS Simulator Skilln0an/VivaDicta1311 repos~2.5kAutomated safety check: PassMIT
Inspector Implementationipedro/Inspector170—~729Automated safety check: PassMIT
Device InteractionInfomaniak/desktop-kDrive1201 repos~1.9kAutomated safety check: PassGPL-3.0
Run iOS SimulatoriPlug2/iPlug2OOS158—~711Automated safety check: PassNone
Evaluating SDK Internal Updatesbitwarden/ios696—~2.6kAutomated safety check: PassGPL-3.0

Similar skills

  • iOS Simulator Skill

    n0an/VivaDicta

    21 production-ready scripts for iOS app testing, building, and automation.

    131 GitHub starsUsed in 1 repo~2.5k tokens
    MobileAuto-check passed
  • Inspector Implementation

    ipedro/Inspector

    A skill your agent uses when an agent needs to implement or modify the Inspector library itself — panel UI, hierarchy/runtime behavior, custom property models, macros, or Example-app dogfooding.

    170 GitHub stars~729 tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Device Interaction

    Infomaniak/desktop-kDrive

    Verify iOS app behavior on device or simulator via screenshots, UI hierarchy, and touch interactions.

    120 GitHub starsUsed in 1 repo~1.9k tokens
    MobileAuto-check passed
  • Run iOS Simulator

    iPlug2/iPlug2OOS

    Build and run an iPlug2 iOS app in the iOS Simulator. An agent skill from iPlug2/iPlug2OOS.

    158 GitHub stars~711 tokensUpdated 24 days ago
    MobileAuto-check passed
  • Official

    Evaluates a bitwarden/ios "Update SDK to" PR against the sdk-swift commit range for compile-time, runtime and serialization breaking changes, maps affected symbols to iOS call sites, and applies…

    696 GitHub stars~2.6k tokensUpdated today
    MobileAuto-check passed
  • iOS Design Guidelines

    ehmo/platform-design-skills

    Apple Human Interface Guidelines for iPhone. An agent skill from ehmo/platform-design-skills.

    606 GitHub stars~9k tokensUpdated 6 mo ago
    MobileAuto-check passed

More from raintree-technology/hig-doctor

All 15 skills in this repo
  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    143 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    143 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hig Components Controls

    raintree-technology/hig-doctor

    Apple HIG guidance for selection and input controls including pickers, toggles, sliders, steppers, segmented controls, combo boxes, text fields, text views, labels, token fields, virtual keyboards…

    143 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hig Components Dialogs

    raintree-technology/hig-doctor

    Apple HIG guidance for presentation components including alerts, action sheets, popovers, sheets, and digit entry views.

    143 GitHub starsUsed in 5 repos~1.1k tokens
    Auto-check passed
  • Hig Components Layout

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for layout and navigation components.

    143 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed
  • Hig Components Menus

    raintree-technology/hig-doctor

    Apple HIG guidance for menu and button components including menus, context menus, dock menus, edit menus, the menu bar, toolbars, action buttons, pop-up buttons, pull-down buttons, disclosure…

    143 GitHub starsUsed in 5 repos~1.1k tokens
    Auto-check passed

Works with

Categories

Questions about Hig Components Status

What does Hig Components Status do?

Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Hig Components Status is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.

When should I use Hig Components Status?

Hig Components Status fits situations like: asked about: progress indicator; loading spinner; progress display; determinate vs indeterminate progress.

How do I install Hig Components Status in Claude Code?

Run `npx skills add raintree-technology/hig-doctor --skill hig-components-status -a claude-code`. Or copy the skill folder (skills/hig-components-status in raintree-technology/hig-doctor) into .claude/skills/hig-components-status in your project. Claude Code loads it when a task matches its description.

How do I install Hig Components Status in Codex?

Run `npx skills add raintree-technology/hig-doctor --skill hig-components-status -a codex`. Or copy the skill folder (skills/hig-components-status in raintree-technology/hig-doctor) into .agents/skills/hig-components-status in your project. Codex loads it when a task matches its description.

Can I use Hig Components Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add raintree-technology/hig-doctor --skill hig-components-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hig-components-status, .gemini/skills/hig-components-status, .github/skills/hig-components-status and .opencode/skills/hig-components-status in your project.

What does Hig Components Status need to run?

SKILL.md names no scripts, command-line tools or credentials: Hig Components Status is instructions for the agent only.

Does Hig Components Status access the network?

SKILL.md names 1 domain. As links in the text: raintree.technology. This is read from the text; nothing was executed.

Is Hig Components Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hig Components Status use?

Hig Components Status is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hig Components Status use?

About 963 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Hig Components Status?

Skills that share tags, products or a category with Hig Components Status: iOS Simulator Skill (n0an/VivaDicta, 131 stars), Inspector Implementation (ipedro/Inspector, 170 stars), Device Interaction (Infomaniak/desktop-kDrive, 120 stars) and Run iOS Simulator (iPlug2/iPlug2OOS, 158 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hig Components Status?

raintree-technology (a GitHub organization) maintains it in raintree-technology/hig-doctor, which has 143 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 11, 2026.

Source: raintree-technology/hig-doctor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.