Agent skill

Hig Components Menus

by raintree-technology in 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…

MITAuto-check passedMobile

Install Hig Components Menus

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

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

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

At a glance

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…

  • Works in 10 steps: Menus should be contextual and… → Use standard button styles.… → Toolbars for frequent actions. Most… → …
  • The user says how should my buttons look
  • 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 Menus is an agent skill from 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 controls, and standard buttons. Use this skill when the user says "how should my buttons look," "what goes in the menu bar," "should I use a context menu or action sheet," "how do I design a toolbar," or asks about button design, menu design, context menu, toolbar, menu bar, action button, pop-up button, pull-down button…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/action-button.md`, `references/buttons.md` and `references/context-menus.md`).

It sits in Mobile, covering iOS development. It works with 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 my buttons look
  • What goes in the menu bar
  • Should I use a context menu
  • How do I design a toolbar

Example prompts

  • “how should my buttons look,”
  • “what goes in the menu bar,”
  • “should I use a context menu or action sheet,”
  • “/hig-components-menus”

Workflow steps

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

  1. Menus should be contextual and predictable. Standard items in standard locations. Follow platform conventions for ordering and grouping.
  2. Use standard button styles. System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.
  3. Toolbars for frequent actions. Most commonly used commands in the toolbar. Rarely used actions belong in menus.
  4. Menu bar is the primary command interface on macOS. Every command reachable from the menu bar. Toolbars and context menus supplement, not…
  5. Context menus for secondary actions. Right-click or long-press, relevant to the item under the pointer. Never put a command only in a…
  6. Pop-up buttons for mutually exclusive choices. Select exactly one option from a set.
  7. Pull-down buttons for action lists. No current selection; they offer a set of commands.
  8. Action buttons consolidate related actions behind a single icon in toolbars or title bars.
  9. Disclosure controls for progressive disclosure. Show or hide additional content.
  10. Dock menus: short and focused on the most useful actions when the app is running.

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 Menus loads about 1.1k tokens when it runs, and up to ~7.9k if it reads all its reference files. Until then it costs about 180 tokens; SKILL.md has 398 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
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.9k

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). 398 words, ~1,092 tokens.

Download SKILL.mdSave it as .claude/skills/hig-components-menus/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
hig-components-menus
description
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 controls, and standard buttons. Use this skill when the user says "how should my buttons look," "what goes in the menu bar," "should I use a context menu or action sheet," "how do I design a toolbar," or asks about button design, menu design, context menu, toolbar, menu bar, action button, pop-up button, pull-down button, disclosure control, dock menu, edit menu, or any menu/button component layout and behavior. Cross-references: hig-components-search, hig-components-controls, hig-components-dialogs.
version
1.0.0

Apple HIG: Menus and Buttons

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

Key Principles

  1. Menus should be contextual and predictable. Standard items in standard locations. Follow platform conventions for ordering and grouping.

  2. Use standard button styles. System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.

  3. Toolbars for frequent actions. Most commonly used commands in the toolbar. Rarely used actions belong in menus.

  4. Menu bar is the primary command interface on macOS. Every command reachable from the menu bar. Toolbars and context menus supplement, not replace.

  5. Context menus for secondary actions. Right-click or long-press, relevant to the item under the pointer. Never put a command only in a context menu.

  6. Pop-up buttons for mutually exclusive choices. Select exactly one option from a set.

  7. Pull-down buttons for action lists. No current selection; they offer a set of commands.

  8. Action buttons consolidate related actions behind a single icon in toolbars or title bars.

  9. Disclosure controls for progressive disclosure. Show or hide additional content.

  10. Dock menus: short and focused on the most useful actions when the app is running.

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

Reference Index

ReferenceTopicKey content
menus.mdGeneral menu designItem ordering, grouping, shortcuts
context-menus.mdContext menusRight-click, long press, secondary actions
dock-menus.mdDock menusmacOS app-level actions, running state
edit-menus.mdEdit menusUndo, copy, paste, standard items
the-menu-bar.mdMenu barmacOS primary command interface, structure
toolbars.mdToolbarsFrequent actions, customization, placement
buttons.mdButtonsSystem styles, sizing, affordance
action-button.mdAction buttonGrouped secondary actions, toolbar use
pop-up-buttons.mdPop-up buttonsMutually exclusive choice selection
pull-down-buttons.mdPull-down buttonsAction lists, no current selection
disclosure-controls.mdDisclosure controlsProgressive disclosure, show/hide

Output Format

  1. Component recommendation -- which menu or button type and why.
  2. Visual hierarchy -- placement, sizing, grouping within the interface.
  3. Platform-specific behavior across iOS, iPadOS, macOS, visionOS.
  4. Keyboard shortcuts (macOS) -- standard and custom shortcuts for menu items and toolbar actions.

Questions to Ask

  1. Which platforms?
  2. Primary or secondary action?
  3. How many actions need to be available?
  4. macOS menu bar app?
  • hig-components-search -- Search fields, page controls alongside toolbars and menus
  • hig-components-controls -- Toggles, pickers, segmented controls complementing buttons
  • hig-components-dialogs -- Alerts, sheets, popovers triggered by menu items or buttons
  • hig-inputs -- Keyboard shortcuts and pointer interactions with menus and toolbars

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 11 other files (references) in skills/hig-components-menus of raintree-technology/hig-doctor.

  • SKILL.md
  • references/action-button.md
  • references/buttons.md
  • references/context-menus.md
  • references/disclosure-controls.md
  • references/dock-menus.md
  • references/edit-menus.md
  • references/menus.md
  • references/pop-up-buttons.md
  • references/pull-down-buttons.md
  • references/the-menu-bar.md
  • references/toolbars.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 Menus 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 Menus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hig Components Menus this skillraintree-technology/hig-doctor1435 repos~1.1kAutomated safety check: PassMIT
macOS Auto Updatefayazara/macos-app-skills676—~1.8kAutomated safety check: PassNone
API Explorationsozercan/kaset2.4k—~454Automated safety check: PassMIT
Dev Loop Packagingsozercan/kaset2.4k—~388Automated safety check: PassMIT
App ItChristian-Katzmann/app-it216—~2.4kAutomated safety check: PassMIT
macOS App Designvaayne/mori303—~789Automated safety check: PassMIT

Similar skills

  • macOS Auto Update

    fayazara/macos-app-skills

    Add Sparkle auto-update support to a native macOS app. An agent skill from fayazara/macos-app-skills.

    676 GitHub stars~1.8k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • API Exploration

    sozercan/kaset

    A skill your agent uses when a task needs a new or modified YouTube Music API call, response parser validation, authenticated endpoint investigation, or fixture capture; explore endpoints with swift…

    2.4k GitHub stars~454 tokensUpdated 6 days ago
    MobileAuto-check passed
  • Dev Loop Packaging

    sozercan/kaset

    A skill your agent uses when you need a fresh packaged .app bundle, a fast build-package-relaunch loop, or a packaged runtime repro for Kaset instead of a compile-only verification.

    2.4k GitHub stars~388 tokensUpdated 6 days ago
    MobileAuto-check passed
  • App It

    Christian-Katzmann/app-it

    Turn a local project or a hosted web app (including a published Claude Artifact URL) into a macOS Dock-launchable .app.

    216 GitHub stars~2.4k tokensUpdated 9 days ago
    MobileAuto-check passed
  • macOS App Design

    vaayne/mori

    A skill your agent uses when designing or building native macOS applications with SwiftUI or AppKit.

    303 GitHub stars~789 tokensUpdated 2 mo ago
    MobileAuto-check passed
  • macOS Tahoe APIs

    KartikLabhshetwar/better-shot

    Guide to macOS 26 Tahoe APIs and features. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 1 repo~518 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 Search

    raintree-technology/hig-doctor

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

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

Works with

Categories

Questions about Hig Components Menus

What does Hig Components Menus do?

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…. Hig Components Menus is an agent skill from 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 controls, and standard buttons.

When should I use Hig Components Menus?

Hig Components Menus fits situations like: the user says how should my buttons look; what goes in the menu bar; should I use a context menu; how do I design a toolbar.

How do I install Hig Components Menus in Claude Code?

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

How do I install Hig Components Menus in Codex?

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

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

What does Hig Components Menus need to run?

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

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

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

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

What are the alternatives to Hig Components Menus?

Skills that share tags, products or a category with Hig Components Menus: macOS Auto Update (fayazara/macos-app-skills, 676 stars), API Exploration (sozercan/kaset, 2.4k stars), Dev Loop Packaging (sozercan/kaset, 2.4k stars) and App It (Christian-Katzmann/app-it, 216 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hig Components Menus?

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.