AgentStack
SKILL verified MIT Self-run

Hig Doctor Audit

skill-raintree-technology-agent-starter-hig-doctor-audit · by raintree-technology

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.

No reviews yet
0 installs
0 views
view→install

Install

$ agentstack add skill-raintree-technology-agent-starter-hig-doctor-audit

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • Prompt-injection patterns
  • Secret / credential exfiltration
  • Dangerous shell & filesystem operations
  • Untrusted network calls
  • Known-malicious package signatures

What it can access

  • Network access No
  • Filesystem access No
  • Shell / process execution No
  • Environment & secrets No
  • Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Hig Doctor Audit? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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.

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:

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:

**/*.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.

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

Reviews

No reviews yet — be the first.

Versions

  • v0.1.0 Imported from the upstream source.