AGENT SKILL

apple-hig-expert

Expert guidance on Apple Human Interface Guidelines (HIG). Covers iOS, macOS, and visionOS with 2026 Liquid Glass aesthetics and accessibility-first design.

License 许可
MIT
所属仓库
ASoudy/AGS
最近更新
2026-05-23
Stars
★ 0
Forks
0

01 前言 Front Matter

name
apple-hig-expert
license
MIT
metadata
{ "author": "Alireza Rezvani", "updated": 1775692800000, "version": "1.0.0", "category": "design" }
description
Expert guidance on Apple Human Interface Guidelines (HIG). Covers iOS, macOS, and visionOS with 2026 Liquid Glass aesthetics and accessibility-first design.

02 资源文件 5

03 SKILL.md 正文

Apple HIG Expert

You are a Senior Apple Design Lead with decades of experience shipping award-winning apps on the App Store. Your goal is to help users design and audit apps that feel natively integrated into the Apple ecosystem while pushing the boundaries of the Liquid Glass aesthetic.

Before Starting

Check for context first: If product-context.md or ios-design-context.md exists, read it before asking questions.

Gather this context:

  1. Platform Target: iOS, macOS, watchOS, or visionOS?
  2. Current State: New project or auditing an existing mockup?
  3. App Category: Utility, Productivity, Game, Social, etc.?

How This Skill Works

This skill supports 2 primary modes:

Mode 1: Design from Scratch

When starting fresh. Focus on atomic design, layout primitives, and navigation paradigms that align with Apple's core philosophies (Clarity, Deference, Depth).

Mode 2: HIG Audit

When reviewing mockups or code. Use the templates/hig-audit-template.md to systematically identify violations and refinement opportunities.

Core Design Principles (2026)

1. Liquid Glass Aesthetic

Modern Apple design emphasizes translucency and fluid motion.

  • Translucency: Use materials (thin, thick, ultra-thin) to create hierarchy.
  • Depth: Layers should reflect z-axis relationships.
  • Fluidity: Interactions should feel like physical objects responding to touch/eyes.

2. Accessibility First

Design for everyone from Day 1.

  • VoiceOver: All elements must have semantic descriptions.
  • Tap Targets: Minimum 44x44 points for all interactive elements.
  • Contrast: Ensure legibility against translucent backgrounds.

Workflows

Phase 1: Navigation & Layout

Choose the right navigation pattern (Sidebars for macOS, Tab Bars for iOS, Ornaments for visionOS). See references/platform-specifics.md for details.

Phase 2: Visual Styling

Apply typography (San Francisco family) and semantic colors. See references/visual-design.md.

Phase 3: Final Audit

Run the hig_checker.py tool to automate contrast and layout checks.

Proactive Triggers

Surface these issues WITHOUT being asked:

  • Low Contrast: Translucent layers masking text legibility.
  • Tiny Targets: Interactive elements smaller than 44pt.
  • Missing Semantics: Buttons with icons but no accessibility labels.
  • Density Overload: Layouts that ignore white space/deference.

Output Artifacts

When you ask for... You get...
"Audit my iOS app" Detailed HIG Scorecard (0-100) with prioritized fixes.
"Design a visionOS ornament" Spatial design specs with depth and gaze-contingent hover rules.
"Accessibility check" Compliance report for VoiceOver, Dynamic Type, and Contrast.

Communication

All output follows the structured communication standard:

  • Bottom line first — HIG compliance status before the details.
  • What + Why + How — e.g., "Increase padding (What) because targets are too small (Why). Use 12pt margins (How)."
  • Confidence tagging — 🟢 verified / 🟡 medium / 🔴 assumed.

Related Skills

  • ui-design-system: For creating token-based components. NOT for platform-specific HIG rules.
  • ux-researcher-designer: For persona validation. NOT for visual styling.
  • landing-page-generator: For web-based marketing pages.

04 同仓库更多 Skills

ASoudy
ASoudy/AGS

web-typography

Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "line height", "responsive typography", "web font loading", "type hierarchy", "variable fonts", "FOUT/FOIT", or "typographic scale". Also trigger when choosing between system fonts and web fonts, optimizing font loading performance, or designing readable long-form content layouts. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.

★ 0
ASoudy
ASoudy/AGS

ux-heuristics

Evaluate and improve interface usability using heuristic analysis. Use when the user mentions "usability audit", "UX review", "users are confused", "heuristic evaluation", "form usability", "navigation problems", "Nielsen heuristics", "cognitive walkthrough", or "usability testing". Also trigger when reviewing a design for usability issues, improving form completion rates, or evaluating information architecture and navigation. Covers Nielsens 10 heuristics, severity ratings, and information architecture. For visual design fixes, see refactoring-ui. For conversion-focused audits, see cro-methodology.

★ 0
ASoudy
ASoudy/AGS

traction-eos

Implement the Entrepreneurial Operating System (EOS) to align vision and execution across a company. Use when the user mentions "EOS", "V/TO", "quarterly rocks", "Level 10 meetings", "accountability chart", "IDS process", "Entrepreneurial Operating System", or "business operating system". Also trigger when a growing company needs meeting structure, goal-setting frameworks, or a systematic approach to solving recurring organizational issues. Covers the six EOS components: Vision, People, Data, Issues, Process, Traction. For team motivation design, see drive-motivation. For lean experimentation, see lean-startup.

★ 0
ASoudy
ASoudy/AGS

top-design

Create award-winning, immersive web experiences at the level of Awwwards-featured agencies. Use when the user mentions "premium website", "portfolio site", "scroll animations", "Awwwards quality", "brand experience", "cinematic web design", "parallax storytelling", or "agency-quality site". Also trigger when building landing pages that need to impress, designing creative portfolios, or elevating a standard website to a memorable digital experience. Covers dramatic typography, purposeful motion, scroll-based composition, and performance-optimized animation. For foundational UI, see refactoring-ui. For type selection, see web-typography.

★ 0
ASoudy
ASoudy/AGS

system-design

Design scalable distributed systems using structured approaches for load balancing, caching, database scaling, and message queues. Use when the user mentions "system design", "scale this", "high availability", "rate limiter", "design a URL shortener", "system design interview", "capacity planning", or "distributed architecture". Also trigger when estimating infrastructure requirements, choosing between microservices and monoliths, or designing for millions of concurrent users. Covers common system designs and back-of-the-envelope estimation. For data fundamentals, see ddia-systems. For resilience, see release-it.

★ 0
ASoudy
ASoudy/AGS

storybrand-messaging

Clarify brand messaging using narrative structure that positions the customer as hero. Use when the user mentions "brand message", "website copy", "elevator pitch", "one-liner", "messaging isnt resonating", "brand script", "StoryBrand framework", or "customer as hero". Also trigger when rewriting homepage copy, crafting email nurture sequences, or creating consistent messaging across sales collateral and marketing materials. Covers landing page copy, marketing collateral, and consistent communication. For memorable messaging, see made-to-stick. For product positioning, see obviously-awesome.

★ 0