# Hig Doctor Audit

> HIG Doctor audit workflow for scanning app projects against Apple Human Interface Guidelines. Use when the user asks for a HIG audit, Apple UI compliance scan, accessibility/design lint, HIG Doctor, severity report, CI gate, or wants to verify SwiftUI, UIKit, React, Next.js, Vue, Svelte, Angular, React Native, Flutter, Compose, Android XML, CSS, or HTML against Apple HIG rules.

- **Type:** Skill
- **Install:** `agentstack add skill-raintree-technology-agent-starter-hig-doctor-audit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [raintree-technology](https://agentstack.voostack.com/s/raintree-technology)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [raintree-technology](https://github.com/raintree-technology)
- **Source:** https://github.com/raintree-technology/agent-starter/tree/main/templates/.claude/skills/hig-doctor-audit
- **Website:** https://claude.raintree.technology

## Install

```sh
agentstack add skill-raintree-technology-agent-starter-hig-doctor-audit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# HIG Doctor Audit

Use this skill as the verification loop for Apple HIG work. It complements the `hig-*` reference skills: run the audit to find concrete concerns, then use the matching HIG skill and reference topic to fix them.

## Tooling

HIG Doctor is documented at  and published as `hig-doctor`.

```bash
npx hig-doctor ./path/to/project
npx hig-doctor ./path/to/project --export
npx hig-doctor ./path/to/project --stdout
npx hig-doctor ./path/to/project --json
npx hig-doctor ./path/to/project --fail-on critical
```

Requires Node 20+ for the published package. From the local source repo, the Bun entrypoint is:

```bash
cd /Users/mb1/Code/secondary/hig-doctor/packages/hig-doctor/src-termcast
bun run audit ./path/to/project
```

## Workflow

1. Confirm the project path and target platform/framework.
2. Run `npx hig-doctor  --export` for a human-readable `hig-audit.md`, or `--json` for CI/scripts.
3. If output is large, focus first on `critical`, then `serious`, then high-confidence `moderate`.
4. Map each category's `skill` field to the matching local HIG skill, such as `hig-foundations` or `hig-components-controls`.
5. Read only the specific HIG reference topics needed for the flagged issue.
6. Fix concrete code issues and rerun the audit with the same flags.
7. For CI, use `--fail-on critical` first. Raise to `serious` only after existing serious issues are cleaned up.

## Ignore File

Use `.higauditignore` for intentional fixtures, generated output, stories, or demos:

```text
**/*.stories.tsx
examples
components/audit-demo-fixtures.ts
```

Keep ignores narrow. Do not hide application UI code to make the audit pass.

## Interpretation

- `critical`: accessibility-breaking or interaction-blocking. Treat as release blockers unless clearly a false positive.
- `serious`: significant HIG or UX degradation. Fix before shipping visible UI.
- `moderate`: style or best-practice drift. Batch when the issue is repeated across a design system.
- `positive`: useful evidence, not work to do.

HIG Doctor is regex-based. Verify each finding against the code and the relevant HIG reference before editing.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [raintree-technology](https://github.com/raintree-technology)
- **Source:** [raintree-technology/agent-starter](https://github.com/raintree-technology/agent-starter)
- **License:** MIT
- **Homepage:** https://claude.raintree.technology

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-raintree-technology-agent-starter-hig-doctor-audit
- Seller: https://agentstack.voostack.com/s/raintree-technology
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.