hig-components-menus — скилл для Claude Code: как внедрить
Скилл помогает проектировать меню и кнопки для интерфейсов Apple по правилам Human Interface Guidelines. Полезен при выборе между pop-up и pull-down кнопками или структурировании тулбаров.
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a claude-codeЧто делает hig-components-menus
Скилл применяет правила Apple HIG к кнопкам и меню в интерфейсах. Он охватывает macOS, iOS, iPadOS и visionOS. Контекстные меню остаются строго вторичными. Скилл запрещает прятать команды исключительно под правый клик или долгое нажатие. Частые действия отправляются на панель инструментов, а редкие команды остаются в основном меню.
Ответы опираются на справочные файлы по кнопкам, док-меню и элементам раскрытия. Формат ответа строго фиксирован: выбор компонента с обоснованием, визуальная иерархия, поведение в целевых ОС и шорткаты для macOS. Pop-up кнопки служат для взаимоисключающего выбора. Pull-down кнопки выводят перечень команд без сохранения выбранного состояния.
Перед уточнением деталей скилл проверяет файл .claude/apple-design-context.md. Если файла нет, ассистент спрашивает о целевых платформах и приоритете действия. Это исключает лишние вопросы.
Какие задачи решает
- выбрать подходящий тип кнопки между pop-up и pull-down
- спроектировать структуру менюбара и тулбара для macOS
- распределить вторичные действия по контекстным меню
- настроить клавиатурные сочетания для пунктов меню
Примеры запросов агенту
- Подскажи, какую кнопку выбрать для фильтрации списка: pop-up или pull-down?
- Как распределить команды между менюбаром и тулбаром в приложении для macOS?
- Какие действия допустимо выносить в контекстное меню по правилам Apple HIG?
Как установить hig-components-menus
1Через Skills CLI (Vercel)
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a claude-code2Вручную: положить файлы
~/.claude/skills/hig-components-menus/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hig-components-menus/
1Через Skills CLI (Vercel)
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a codex2Вручную: положить файлы
.agents/skills/hig-components-menus/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a cursor2Вручную: положить файлы
.cursor/skills/hig-components-menus/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install raintree-technology/hig-doctor hig-components-menus2Вручную: положить файлы
.github/skills/hig-components-menus/SKILL.md1Через Skills CLI (Vercel)
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a gemini-cli2Командой платформы
gemini skills install https://github.com/raintree-technology/hig-doctor --path skills/hig-components-menusВручную: положить файлы
.devin/skills/hig-components-menus/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hig-components-menus
Как установить hig-components-menus в Claude Code?
Выполните команду npx skills add raintree-technology/hig-doctor --skill hig-components-menus -a claude-code. Конфигурация запишется по пути ~/.claude/skills/hig-components-menus/SKILL.md.
Что делает hig-components-menus?
Скилл даёт рекомендации по проектированию меню, кнопок и панелей инструментов в экосистеме Apple. Он следит за соблюдением принципов визуальной иерархии и платформенных соглашений.
Зачем скиллу файл .claude/apple-design-context.md?
Скилл считывает из него контекст проекта перед началом работы. Это позволяет сразу выдавать точные рекомендации без лишних вопросов о целевых платформах.
Исходный текст
SKILL.md · MIT
--- name: hig-components-menus version: 1.0.0 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. --- # 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. ## Reference Index | Reference | Topic | Key content | |---|---|---| | [menus.md](references/menus.md) | General menu design | Item ordering, grouping, shortcuts | | [context-menus.md](references/context-menus.md) | Context menus | Right-click, long press, secondary actions | | [dock-menus.md](references/dock-menus.md) | Dock menus | macOS app-level actions, running state | | [edit-menus.md](references/edit-menus.md) | Edit menus | Undo, copy, paste, standard items | | [the-menu-bar.md](references/the-menu-bar.md) | Menu bar | macOS primary command interface, structure | | [toolbars.md](references/toolbars.md) | Toolbars | Frequent actions, customization, placement | | [buttons.md](references/buttons.md) | Buttons | System styles, sizing, affordance | | [action-button.md](references/action-button.md) | Action button | Grouped secondary actions, toolbar use | | [pop-up-buttons.md](references/pop-up-buttons.md) | Pop-up buttons | Mutually exclusive choice selection | | [pull-down-buttons.md](references/pull-down-buttons.md) | Pull-down buttons | Action lists, no current selection | | [disclosure-controls.md](references/disclosure-controls.md) | Disclosure controls | Progressive 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? ## Related Skills - **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](https://raintree.technology) · [More developer tools](https://raintree.technology)*
© raintree-technology · MIT · raintree-technology/hig-doctor