/hig-doctor-audit

name: hig-doctor-audit
description: Audit interface source with HIG Doctor when the user asks to scan, lint, review, or remediate Swift, UIKit, AppKit, React, Vue, Svelte, Angular, Compose, Android XML, Flutter, CSS, or HTML for HIG-aligned interface and accessibility concerns. Do not activate for general design advice without source to audit; use the relevant HIG guidance skill instead.

HIG Doctor audit

Use HIG Doctor findings as review evidence, not certification.

Audit workflow

1. Confirm the target repository or directory. Keep the scan within that scope. 2. Run `npx -y hig-doctor@2.0.3 <target> --json` for machine-readable findings. 3. Report the detected frameworks, severity counts, rule IDs, locations, and material analysis limits. 4. Use `hig_explain_finding` or the relevant bundled HIG skill when a finding needs its cited guidance and context. 5. Before editing, distinguish mechanical fixes from changes that require product, design, accessibility, or platform judgment. 6. If the user authorized remediation, preserve justified suppressions and rerun the audit plus the repository's relevant checks.

Gates and baselines

• Use `--fail-on <critical|serious|moderate>` only when the requested workflow

needs a gate.

• Use `--write-baseline` only when the user asks to adopt a baseline. A baseline

records accepted existing findings; it does not resolve them.

• Do not delete or weaken configuration, inline suppressions, or baselines merely

to produce a clean result.

Failure handling

If `npx` or the package cannot run, state the failed command and the missing prerequisite. Ask the user to install a supported Node.js runtime or restore package-registry access. Do not substitute an unversioned audit command.

Output

Lead with the audit result. Separate confirmed findings, judgment-dependent warnings, preserved exceptions, checks run, and missing evidence. Never claim that an automated scan proves HIG compliance or accessibility.