About hig-doctor
hig-doctor is a multi-skill diagnostic tool for finding and fixing Apple HIG violations in UI code or designs. It covers component categories from controls and layouts to inputs and visual foundations, and provides guideline-specific explanations and fixes.
Key features
- 01Diagnoses Apple HIG violations
- 02Coverage by UI component category
- 03Explains relevant guidelines
- 04Provides targeted fixes
Use cases
- 01Auditing button and toggle behavior
- 02Checking navigation and tab layouts
- 03Reviewing forms and text fields
- 04Finding color or typography issues
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/hig-doctorin Claude Code to confirm it loaded.
Bundled filesstub.yaml
Details
From the project READMEhig-doctor
Catalogue stub — full package: raintree-technology/hig-doctor
Decision tree
Run this to diagnose and fix Apple HIG violations:
-
Is the HIG Doctor skill already installed? Check:
~/.design-agent-skills/skills/hig-foundations/SKILL.mdexists.- Yes → invoke the relevant hig-doctor skill and proceed
- No → go to step 2
-
Do you have shell access?
- Yes → run the install command below, then invoke the skill
- No → show the install command; in Claude Code, send it as a chat message starting with
!— add-gfor global install or omit for project-only
Install command
npx skills add raintree-technology/hig-doctor
Website: apple.raintree.technology
Invoke after install
Skills diagnose by component category — invoke the one matching your problem area:
hig-components-controls— button, toggle, slider violationshig-components-layout— navigation bar, tab bar violationshig-components-menus— context menu, picker violationshig-components-dialogs— alert, sheet violationshig-inputs— text field, form violationshig-foundations— color, typography, spacing violations
Trigger phrases: "HIG compliance", "Apple HIG audit", "diagnose HIG"
What it does
HIG Doctor is a multi-skill diagnostic tool for Apple HIG compliance. Each skill covers a category of HIG components, identifies violations in your UI code or design, explains the specific guideline being broken, and provides targeted fixes. Companion to apple-hig-skills (which teaches guidelines) — this diagnoses and repairs.