Agent skill

HIG Doctor Skill: Apple HIG Audits for AI Agents

HIG Doctor checks Apple-platform and web source against Apple's Human Interface Guidelines with a 431-rule audit CLI, an MCP server and 14 reference skills.

Install
npx hig-doctor .
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is HIG Doctor?

HIG Doctor is an open-source toolkit from Raintree Technology that audits Apple-platform source against the Human Interface Guidelines and web or cross-platform source against aligned accessibility rules. It ships a CLI with 431 rules across 14 frameworks, an MCP server and 14 reference skills.

HIG Doctor helps developers and coding agents find interface issues before release. It checks Apple-platform source against Apple's Human Interface Guidelines, and web and cross-platform source against accessibility and interface-quality rules that align with them.

It has four surfaces: an audit CLI for scans and CI gates, an MCP server for lookup and audits, agent skills with design guidance, and a core package for embedding the rule engine.

What the audit reports

  • Findings carry severity, file and line, a rule ID, fix guidance and the reference behind the concern.
  • The catalog holds 431 rules across 14 frameworks, including SwiftUI, UIKit, React and Next.js, CSS and SCSS, Vue, Angular, Svelte, Flutter and Compose.
  • Configuration, inline suppressions, content-based baselines, SARIF output and a fail-on flag let you gate only new problems.
  • Precision and recall are measured on an annotated fixture corpus and enforced in CI.

Who HIG Doctor is for

Best for

  • Teams shipping SwiftUI, UIKit or AppKit apps that want HIG checks in review and CI.
  • Web teams that want a rule-based interface and accessibility scan alongside manual review.
  • Agents that need bounded reference lookups, next to swiftui-expert-skill or apple-design.

Not for

  • Proof of conformance. The README says findings support review and do not prove accessibility, HIG conformance or design quality.
  • Live HIG text. The bundled skills are a frozen 2025-02-02 snapshot; Apple's live guidelines remain canonical.
  • Android-first teams expecting Material rules. The README describes its Android XML and Compose rules as HIG-aligned universal checks.

Use it with UiChemy

Web and CSS rules in HIG Doctor can scan the front end of a WordPress theme or a page exported from a UiChemy build. Fix findings in the editor afterwards. Click Get Started on uichemy.com.