Can I use this without Claude?

Yes, the audit CLI works from any terminal and can export JSON or markdown for other tools or CI systems.

Is the HIG content kept up to date?

The skills corpus is a dated snapshot; canonical guidelines remain on developer.apple.com and the structure here is MIT-licensed.

How do I configure the MCP server?

Add the bun command and absolute path to the hig-doctor MCP entry inside your client's MCP server configuration file.

raintree-technology/apple-hig-skills

Apple Human Interface Guidelines structured as skills for AI agents.

SkillsAgent Skills 72Open source

View on GitHub

Updated 2026-06-16

raintree-technology/apple-hig-skills GitHub repository

What is raintree-technology/apple-hig-skills?

The project organizes the full set of Apple Human Interface Guidelines into discrete skills that AI coding agents can query and apply. It adds an MCP server exposing list, lookup and audit functions plus a universal scanner that emits severity-bucketed reports.

Agents or developers run the audit against any supported codebase to surface critical, serious or moderate violations. Positive patterns such as semantic colors and Dynamic Type support are also counted and reported.

Primary users are AI coding agents working inside Claude Code, Cursor or Windsurf, though human developers can invoke the same tools via CLI or MCP configuration.

What you can build with raintree-technology/apple-hig-skills

Run compliance checks on new UI code

Point the audit CLI at a project directory to receive a markdown or JSON report that flags accessibility, typography and layout issues before code review.

Look up specific HIG topics inside an agent session

Use the hig_lookup tool to retrieve reference markdown for any skill or topic so the agent can apply the correct pattern while generating SwiftUI or React components.

Add HIG verification to a CI pipeline

Configure the --fail-on flag in automated builds so merges are blocked when serious or critical violations are detected across any of the twelve supported frameworks.

Install raintree-technology/apple-hig-skills

Install

/plugin marketplace add raintree-technology/hig-doctor

Quick start

# From a git clone of this repo
bun packages/hig-doctor/src-mcp/src/index.ts

1Clone the repository and ensure Bun is installed.
2Run the MCP server with bun packages/hig-doctor/src-mcp/src/index.ts.
3Add the server entry to your Claude Desktop config file.
4Optionally install as a Claude Code plugin using the marketplace command.
5Execute the audit CLI against a target directory to generate the first report.