{
  "markdown": "# HIG Compliance Auditor\n\nA Claude Code skill that audits codebases and design systems against Apple's Human Interface Guidelines (HIG), generates detailed compliance reports with severity tiers, and applies remediation changes on user approval.\n\nI built this skill to bring the rigor of Apple's design standards into the development workflow. Instead of manually cross-referencing HIG documentation, you can run a comprehensive audit directly inside Claude Code and get actionable, attributed fixes for every violation found.\n\n## What It Does\n\n- Scans Swift, SwiftUI, UIKit, CSS, HTML, JavaScript, and design tokens for HIG violations\n- Generates structured audit reports with severity levels: Critical, High, Medium, Low\n- Covers typography, color systems, Liquid Glass materials, layout, accessibility, and platform-specific patterns\n- Supports iOS, iPadOS, macOS, watchOS, tvOS, visionOS, and Web/PWA targets\n- Presents multiple remediation options for complex issues and waits for your approval before applying fixes\n- Produces before/after comparisons and git-compatible diffs\n- All fixes include inline attribution comments referencing the specific HIG guideline\n\n## Installation\n\n### Claude Code (CLI)\n\n```bash\nnpx skills add omrajguru05/hig-compliance-auditor\n```\n\nAfter installation, restart Claude Code or start a new conversation to activate the skill.\n\n### Plugin Marketplace\n\n```\n/plugin marketplace add omrajguru05/hig-compliance-auditor\n/plugin install hig-compliance-auditor@omrajguru05-hig-compliance-auditor\n```\n\nAfter installation, restart Claude Code or start a new conversation to activate the skill.\n\n### Claude.ai (Web)\n\nDownload the `hig-compliance-auditor.skill` file from the root of this repo, then upload it at **Settings > Customize > Skills** in Claude.ai (Pro/Max/Team/Enterprise). After uploading, restart Claude Code or start a new conversation to activate the skill.\n\n### Manual Installation\n\n```bash\ncurl -sfL https://raw.githubusercontent.com/omrajguru05/hig-compliance-auditor/main/install.sh | bash\n```\n\nAfter installation, restart Claude Code or start a new conversation to activate the skill.\n\n## Usage\n\nHere are some example prompts that will trigger the skill:\n\n```\nAudit this project for HIG compliance\n```\n\n```\nCheck my SwiftUI code against Apple's Human Interface Guidelines\n```\n\n```\nRun an accessibility audit for iOS\n```\n\n```\nIs my web app following Apple's design standards for PWA?\n```\n\n```\nPrepare this app for App Store review - check compliance\n```\n\n```\nAudit the Liquid Glass CSS implementation in my navigation bar\n```\n\nThe skill walks you through a structured workflow:\n\n1. **Pre-audit configuration** - You choose the audit scope, target platforms, and framework\n2. **Codebase scanning** - The skill analyzes your code against the HIG knowledge base\n3. **Audit report** - A detailed Markdown report with every issue, its severity, and recommended fixes\n4. **Your approval** - You select which issues to fix and which remediation approach you prefer\n5. **Automated remediation** - Fixes are applied with full attribution in the code comments\n6. **Continuous monitoring** (optional) - Track compliance over time with baseline comparisons\n\n## Audit Coverage\n\n### Foundations\n- Typography and Dynamic Type compliance (SF Pro Text/Display threshold, tracking adjustments, 200% scaling)\n- Semantic color system and Dark Mode architecture (dual-tier backgrounds, contrast ratios)\n- Liquid Glass material application (control layer vs content layer rules, scroll-edge transitions)\n- Layout and safe areas (touch targets, Dynamic Island, home indicator)\n- Iconography and SF Symbols (weight matching, filled vs outlined context, licensing)\n\n### Platform-Specific\n- **iOS/iPadOS**: Thumb-zone ergonomics, Dynamic Island, tab bar rules, sidebar navigation on iPad\n- **macOS**: Menu bar integration, keyboard shortcuts, multi-window support, toolbar patterns\n- **watchOS**: Glanceability, full-width touch targets, Digital Crown, pure black backgrounds\n- **tvOS**: Focus engine, parallax effects, top tab bars, TV-safe areas\n- **visionOS**: Spatial ergonomics, Ornaments, gaze-and-pinch targets, no head-locked UI\n\n### Web/PWA\n- PWA manifest configuration (standalone display, theme-color, apple-touch-icon)\n- Liquid Glass CSS implementation (four-layer technique with backdrop-filter)\n- System font stack and tracking adjustments\n- SF Symbols licensing compliance (alternatives: Phosphor, Lucide, Heroicons)\n- Interaction fidelity (tap delay, text selection, gesture conflicts, safe-area-inset)\n\n### Compliance\n- App Store Review Guidelines 2025/2026\n- Accessibility (VoiceOver, Dynamic Type, color contrast, motor, motion sensitivity)\n- AI transparency requirements (2026)\n- Deceptive design avoidance (2026 ad policies)\n\n## Project Structure\n\n```\nhig-compliance-auditor/\n  .claude-plugin/\n    plugin.json\n  skills/\n    hig-compliance-auditor/\n      SKILL.md\n      references/\n        hig-foundations.md\n        platform-paradigms.md\n        web-pwa-adaptation.md\n        compliance-checklists.md\n  install.sh\n  hig-compliance-auditor.skill\n  README.md\n  LICENSE\n```\n\n## Knowledge Base\n\nThe skill's reference material is organized into four focused files that Claude loads on demand based on the audit scope:\n\n| File | Contents |\n|------|----------|\n| `hig-foundations.md` | Core principles (Clarity, Deference, Depth, Hierarchy, Harmony, Consistency), typography metrics, semantic colors, Liquid Glass rules, layout constraints, SF Symbols |\n| `platform-paradigms.md` | iOS/iPadOS, macOS, watchOS, tvOS, visionOS paradigms with platform-specific audit checks |\n| `web-pwa-adaptation.md` | PWA configuration, Liquid Glass CSS implementation, system font stacks, icon licensing, interaction fidelity |\n| `compliance-checklists.md` | UX/UI dos and don'ts, App Store review requirements, accessibility audit matrix, AI transparency rules |\n\nAll guidance and technical specifications derive from Apple's Human Interface Guidelines. I do not claim authorship of Apple's design principles or framework specifications.\n\n## Attribution\n\nAll design principles, guidelines, and technical specifications referenced in this skill are sourced from [Apple's Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/). This skill provides a structured audit workflow and remediation tooling built on top of that publicly available guidance.\n\n## About Me\n\nI am Om Rajguru. I built this skill to help developers and designers ship apps that meet Apple's bar for quality and compliance.\n\n- Website: [omrajguru.com/linktree](https://omrajguru.com/linktree)\n- Portfolio: [om.bearblog.dev/projects](https://om.bearblog.dev/projects)\n- GitHub: [@omrajguru05](https://github.com/omrajguru05)\n- X: [@omrajguru_](https://x.com/omrajguru_)\n\n## License\n\nMIT\n",
  "bytes": 6811,
  "sha": "c09b14cf3f83227837f6cfd7c28fc7f5c2afd74ad0a2df635af038485d7cad70",
  "repo_slug": "omrajguru05/hig-compliance-auditor",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_omrajguru05_hig_compliance_auditor_hig_c_45d2f293/readme"
}