hig-doctor — скилл для Claude Code: аудит кода по Apple HIG
Прогоняет HIG Doctor CLI по вашему коду на Swift, React, Flutter или CSS, показывает проблемы с Apple HIG и доступностью по серьёзности и помогает их исправить.
MIT 203 установок ★ 35 обновлён 2026-10-21
npx skills add podo/design-agent-skills --skill hig-doctor -a claude-codeЧто делает hig-doctor
Скилл оборачивает HIG Doctor CLI в рабочий процесс. Берёт репозиторий или каталог, запускает npx -y hig-doctor@<version> <target> --json и разбирает отчёт: какие фреймворки нашлись, сколько замечаний на каждом уровне серьёзности, ID правил, места в коде и где анализ останавливается.
Дальше находки делятся на две кучи: механические правки и то, что требует решения по продукту, дизайну или доступности. Если разрешить, скилл исправляет и перезапускает аудит. Обоснованные подавления и baseline при этом сохраняются. Результат сканирования он не выдаёт за подтверждённое соответствие HIG.
Нужен Node.js с npx и доступ к npm-реестру: без них команда просто не стартует. И проверять должно что-то реальное — общие советы по Apple-дизайну берут из apple-hig-skills, а для SwiftUI или веб-аудита по WCAG есть swiftui-patterns и wcag-audit-patterns.
Какие задачи решает
- Прогнать вёрстку на React или Vue через проверку правил Apple HIG
- Разложить находки по серьёзности и понять, с чего начинать правки
- Отличить механические исправления от решений, где нужен дизайнер
- Поправить найденное и перепроверить повторным запуском
- Сохранить обоснованные подавления и baseline между прогонами
Примеры запросов агенту
- Проверь
src/componentsна соответствие Apple HIG и покажи находки по серьёзности - Запусти HIG doctor по репозиторию и скажи, что из этого чинится механически
- Исправь проблемы доступности из отчёта и перезапусти аудит
Как установить hig-doctor
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill hig-doctor -a claude-code2Вручную: положить файлы
~/.claude/skills/hig-doctor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hig-doctor/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill hig-doctor -a codex2Вручную: положить файлы
.agents/skills/hig-doctor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill hig-doctor -a cursor2Вручную: положить файлы
.cursor/skills/hig-doctor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/hig-doctor2Вручную: положить файлы
.github/skills/hig-doctor/SKILL.md1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill hig-doctor -a gemini-cli2Командой платформы
gemini skills install https://github.com/podo/design-agent-skills --path skills/hig-doctorВручную: положить файлы
.devin/skills/hig-doctor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill hig-doctor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hig-doctor
Как установить hig-doctor в Claude Code?
Выполните npx skills add podo/design-agent-skills --skill hig-doctor -a claude-code. Скилл появится по пути ~/.claude/skills/hig-doctor/SKILL.md.
Что делает hig-doctor?
Запускает HIG Doctor CLI по исходникам интерфейса и отдаёт отчёт: фреймворки, серьёзность, ID правил и места в коде. Потом помогает исправить находки и перепроверяет результат.
Что нужно, чтобы скилл заработал?
Node.js с npx и доступ к npm-реестру на момент аудита: команда npx -y hig-doctor@<version> <target> --json тянет пакет из реестра. Без исходников проверять нечего.
Исходный текст
SKILL.md · MIT
--- name: hig-doctor description: | Audits interface source code (Swift, UIKit, AppKit, React, Vue, Svelte, Angular, Compose, Android XML, Flutter, CSS, HTML) for Apple HIG-aligned interface and accessibility problems by running the HIG Doctor CLI, then reports findings by severity and helps remediate them. Review evidence, not certification. triggers: - "HIG doctor" - "HIG compliance" - "Apple HIG audit" - "HIG diagnosis" - "fix Apple HIG" das: type: skill category: visual-components upstream: "https://github.com/raintree-technology/hig-doctor" upstream_path: "plugin/skills/hig-doctor-audit/SKILL.md" version: latest install: true --- # hig-doctor > Catalogue stub — full skill: [raintree-technology/hig-doctor](https://github.com/raintree-technology/hig-doctor/tree/main/plugin/skills/hig-doctor-audit) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `hig-doctor-audit`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/hig-doctor-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/hig-doctor-audit/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `hig-doctor-audit`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/hig-doctor ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add raintree-technology/hig-doctor/plugin/skills/hig-doctor-audit -g -y ``` **Project:** ```bash npx skills add raintree-technology/hig-doctor/plugin/skills/hig-doctor-audit -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** Node.js with npx and npm registry access at audit time (the skill runs a version-pinned `npx -y hig-doctor@<version> <target> --json`); optional companion for the guidance behind each finding: the apple-hig-skills pointer (the hig-* reference skills) - **License:** MIT (tooling; Apple reference content is attributed, see upstream THIRD_PARTY_NOTICES.md) <!-- das:install:end --> ## Invoke after install - Skill name: `hig-doctor-audit` - Trigger phrases: "HIG compliance", "Apple HIG audit", "scan this code for HIG issues", "fix Apple HIG" ## What it does A scan-and-remediate workflow around the HIG Doctor CLI. Given a repository or directory, it runs the version-pinned `npx -y hig-doctor@<version> <target> --json`, reports the detected frameworks, severity counts, rule IDs, locations and analysis limits, separates mechanical fixes from changes that need product, design or accessibility judgment, and, if you authorise remediation, fixes and re-runs the audit. It preserves justified suppressions and baselines and never claims that a scan proves HIG compliance. It does nothing useful without source code to audit. Needs Node.js with `npx` and npm registry access. The guidance behind each finding comes from the HIG reference skills, which are a separate pointer: `apple-hig-skills`. ## When NOT to use - General Apple design advice with no source to audit — use `apple-hig-skills` (the `hig-*` reference skills) - SwiftUI implementation help — use `swiftui-patterns` or `swiftui-claude-skills` - Web accessibility conformance audits — use `wcag-audit-patterns`
© podo · MIT · podo/design-agent-skills