Agent skill

Hig Components Search

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

Apple HIG guidance for navigation-related components including search fields, page controls, and path controls.

MITAuto-check passedMobile

Install Hig Components Search

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

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

GitHub CLI
$ gh skill install raintree-technology/hig-doctor hig-components-search --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-search .claude/skills/hig-components-search && 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-search
GitHub stars
143
Used in
5 other repos
Token cost
~828 tokens
SKILL.md length
315 words
Files
4 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Apple HIG guidance for navigation-related components including search fields, page controls, and path controls.

  • Works in 8 steps: Search: discoverable with instant… → Page controls: position in a flat page… → Path controls: file hierarchy… → …
  • The user says how should search work in my app
  • 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 Search is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for navigation-related components including search fields, page controls, and path controls. Use this skill when the user says "how should search work in my app," "I need a breadcrumb," "how do I paginate content," or asks about search field, search bar, page control, path control, breadcrumb, navigation component, search UX, search suggestions, search scopes, paginated content navigation, or file path hierarchy display. Cross-references: hig-components-menus, hig-components-controls…

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/page-controls.md`, `references/path-controls.md` and `references/search-fields.md`).

It sits in Mobile, covering iOS development. It works with iOS and macOS. 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

  • The user says how should search work in my app
  • I need a breadcrumb
  • How do I paginate content
  • Asks about search field

Example prompts

  • “how should search work in my app,”
  • “I need a breadcrumb,”
  • “how do I paginate content,”
  • “/hig-components-search”

Workflow steps

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

  1. Search: discoverable with instant feedback. Place search fields where users expect them (top of list, toolbar/navigation bar). Show…
  2. Page controls: position in a flat page sequence. For discrete, equally weighted pages (onboarding, photo gallery). Show current page and…
  3. Path controls: file hierarchy navigation. macOS path controls display location within a directory structure and allow jumping to any…
  4. Search scopes narrow large result sets. Provide scope buttons so users can filter without complex queries.
  5. Clear empty states for search. Helpful message suggesting corrections or alternatives, not a blank screen.
  6. Page controls are not for hierarchical navigation. Flat, linear sequences only. Use navigation controllers, tab bars, or sidebars for…
  7. Keep path controls concise. Show meaningful segments only. Users can click any segment to navigate directly.
  8. Support keyboard for search. Command-F and system search shortcuts should activate search.

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 Search loads about 828 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 142 tokens; SKILL.md has 315 words of instructions outside code blocks.

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

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). 315 words, ~828 tokens.

Download SKILL.mdSave it as .claude/skills/hig-components-search/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
hig-components-search
description
Apple HIG guidance for navigation-related components including search fields, page controls, and path controls. Use this skill when the user says "how should search work in my app," "I need a breadcrumb," "how do I paginate content," or asks about search field, search bar, page control, path control, breadcrumb, navigation component, search UX, search suggestions, search scopes, paginated content navigation, or file path hierarchy display. Cross-references: hig-components-menus, hig-components-controls, hig-components-dialogs, hig-patterns.
version
1.0.0

Apple HIG: Navigation 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. Search: discoverable with instant feedback. Place search fields where users expect them (top of list, toolbar/navigation bar). Show results as the user types.

  2. Page controls: position in a flat page sequence. For discrete, equally weighted pages (onboarding, photo gallery). Show current page and total count.

  3. Path controls: file hierarchy navigation. macOS path controls display location within a directory structure and allow jumping to any ancestor.

  4. Search scopes narrow large result sets. Provide scope buttons so users can filter without complex queries.

  5. Clear empty states for search. Helpful message suggesting corrections or alternatives, not a blank screen.

  6. Page controls are not for hierarchical navigation. Flat, linear sequences only. Use navigation controllers, tab bars, or sidebars for hierarchy.

  7. Keep path controls concise. Show meaningful segments only. Users can click any segment to navigate directly.

  8. Support keyboard for search. Command-F and system search shortcuts should activate search.

Reference Index

ReferenceTopicKey content
search-fields.mdSearch fieldsScopes, tokens, instant results, placement
page-controls.mdPage controlsDot indicators, flat page sequences
path-controls.mdPath controlsBreadcrumbs, ancestor navigation

Output Format

  1. Component recommendation -- search field, page control, or path control, and why.
  2. Behavior specification -- interaction model (search-as-you-type, swipe for pages, click-to-navigate for paths).
  3. Platform differences across iOS, iPadOS, macOS, visionOS.

Questions to Ask

  1. What type of content is being searched or navigated?
  2. Which platforms?
  3. How large is the dataset?
  4. Is search the primary interaction?
  • hig-components-menus -- Toolbars and menu bars hosting search and navigation controls
  • hig-components-controls -- Text fields, pickers, segmented controls in search interfaces
  • hig-components-dialogs -- Popovers and sheets for expanded search or filtering
  • hig-patterns -- Navigation patterns and information architecture
  • hig-foundations -- Typography and layout for navigation components

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-search of raintree-technology/hig-doctor.

  • SKILL.md
  • references/page-controls.md
  • references/path-controls.md
  • references/search-fields.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 Search 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 Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hig Components Search this skillraintree-technology/hig-doctor1435 repos~828Automated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca89k1 repos~584Automated safety check: PassApache-2.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
Swiftui Expert Skillomarshahine/HomeClaw1754 repos~2.8kAutomated safety check: PassMIT
Phoneagentrounak/PhoneAgent800—~2.2kAutomated safety check: PassMIT
Apple Designvrcm-team/VRCM1801 repos~6.2kAutomated safety check: PassMIT

Similar skills

  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    89k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Swiftui Expert Skill

    omarshahine/HomeClaw

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management, view composition, performance, Liquid Glass adoption, or Instruments .trace…

    175 GitHub starsUsed in 4 repos~2.8k tokens
    MobileAuto-check passed
  • Phoneagent

    rounak/PhoneAgent

    Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.

    800 GitHub stars~2.2k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Apple Design

    vrcm-team/VRCM

    Cross-platform UI/UX design reviewer grounded in Apple's Human Interface Guidelines (122 pages pulled from developer.apple.com, including 57 component pages) plus a design-craft lens for…

    180 GitHub starsUsed in 1 repo~6.2k tokens
    MobileAuto-check passed
  • Swiftui Expert Skill

    Eslzzyl/Pixiv-SwiftUI

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and @Observable data flow, view composition, resizable layouts, safe areas, display…

    111 GitHub starsUsed in 1 repo~2.9k tokens
    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 Search

What does Hig Components Search do?

Apple HIG guidance for navigation-related components including search fields, page controls, and path controls. Hig Components Search is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for navigation-related components including search fields, page controls, and path controls.

When should I use Hig Components Search?

Hig Components Search fits situations like: the user says how should search work in my app; I need a breadcrumb; how do I paginate content; asks about search field.

How do I install Hig Components Search in Claude Code?

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

How do I install Hig Components Search in Codex?

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

Can I use Hig Components Search 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-search -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-search, .gemini/skills/hig-components-search, .github/skills/hig-components-search and .opencode/skills/hig-components-search in your project.

What does Hig Components Search need to run?

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

Does Hig Components Search 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 Search 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 Search use?

Hig Components Search 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 Search use?

About 828 tokens (SKILL.md is roughly 3.3k 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.7k tokens, read only when the agent opens those files.

What are the alternatives to Hig Components Search?

Skills that share tags, products or a category with Hig Components Search: Orca iOS Simulator Control (stablyai/orca, 89k stars), Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars), Swiftui Expert Skill (omarshahine/HomeClaw, 175 stars) and Phoneagent (rounak/PhoneAgent, 800 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hig Components Search?

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.