CtrlK
BlogDocsLog inGet started
Tessl Logo

apple-hig-expert

Audits and designs iOS/macOS/watchOS/visionOS interfaces against the Apple Human Interface Guidelines, including the Liquid Glass design language (announced WWDC25, shipped with iOS 26/macOS Tahoe, Sept 2025). Use when reviewing an Apple-platform mockup or app for HIG compliance, checking contrast or tap-target sizes, or designing native-feeling Apple UI (e.g., 'audit my iOS app against the HIG', 'is this text readable on Liquid Glass?').

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is apple-hig-expert in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strongly actionable, well-organized body whose executable tool guidance and worked example are excellent. The weaknesses are structural: every referenced bundle file is missing from the skill directory, and the batch-audit workflow never closes the loop by re-running the checker after fixes. Time-sensitive version details scattered through the evergreen sections will also rot quickly.

Suggestions

Add an explicit fix-then-revalidate step to Mode 2: after applying fixes, re-run 'python3 scripts/hig_checker.py batch audit.json' and only report 'ship' status once the score reaches the 90+ threshold — this closes the feedback loop the batch workflow requires.

Ship the referenced bundle files ('references/visual-design.md', 'references/accessibility.md', 'references/platform-specifics.md', 'scripts/hig_checker.py', 'templates/hig-audit-template.md') or inline their essential content — currently every referenced path is missing from the bundle, so the skill's core audit workflow cannot actually be executed as written.

Consolidate the version/date details (WWDC25 announcement, iOS 26/macOS Tahoe, Sept 2025 ship dates) out of the intro and Core Design Principles into a single short 'Version notes' or 'Deprecated patterns' section so the evergreen guidance does not rot with each OS release.

DimensionReasoningScore

Conciseness

The body is dense and lean — exact CLI invocations, the batch JSON input shape, a worked example with real output, and numbered fixes — but time-sensitive version/date details ('announced at WWDC25, June 2025; shipped Sept 2025 across iOS 26, iPadOS 26, macOS Tahoe...') appear in the intro and in Core Design Principles #1 outside any 'old patterns'/'deprecated' section, which the guidelines penalize. This is a minor, trimmable amount of over-explanation (anchor 4) rather than a broader tightness problem (anchor 3).

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: three concrete subcommands with real expected output ('python3 scripts/hig_checker.py contrast "#8E8E93" "#FFFFFF" -> Contrast Ratio: 3.26 [FAILED]'), the batch JSON input shape, and a worked example whose fixes include specific values ('darken to >= #6E6E73 on white', 'expand the hit region to 44x44 with padding/contentShape'). Matches anchor 5; the examples cover the common audit cases.

5 / 5

Workflow Clarity

The Mode 1/Mode 2 sequence is clearly laid out with per-check pass/fail and scorecard thresholds (90-100 ship, 70-80 fix, <70 rework), but the batch-audit workflow lacks an explicit fix-then-re-run feedback loop: the worked example delivers findings and fixes without re-running 'hig_checker.py batch' to confirm the score recovers. The scoring notes cap workflow_clarity at 3 when feedback loops are missing in batch-operation contexts, so this cannot score 4 despite the otherwise clean sequencing.

3 / 5

Progressive Disclosure

The body's structure is well-designed — clearly signaled, one-level-deep references to 'references/visual-design.md', 'references/accessibility.md', 'references/platform-specifics.md', 'scripts/hig_checker.py', and 'templates/hig-audit-template.md' — but none of these files exist in the bundle (no references/, scripts/, assets/, or templates/ directories are present), so every referenced path dangles and navigation dead-ends. Scored against the actual bundle structure per the guidelines, the cross-file organization is unfulfilled: a 3 ('some structure but could be better organized'), not the 4-5 the design would earn if the files shipped.

3 / 5

Total

15

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete actions, an explicit 'Use when...' clause with realistic quoted trigger phrases, third-person voice, and a well-scoped niche. The only quibble is the parenthetical version history ('announced WWDC25, shipped with iOS 26/macOS Tahoe, Sept 2025'), which is informative rather than padding and does not detract from any dimension.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Audits and designs iOS/macOS/watchOS/visionOS interfaces against the Apple Human Interface Guidelines', 'checking contrast or tap-target sizes', 'designing native-feeling Apple UI' — with comprehensive coverage inside its niche. Matches the anchor-5 example pattern ('Extract text and tables from PDF files, fill forms, merge documents'); no minor gaps that would justify a 4.

5 / 5

Completeness

Explicitly answers both: what ('Audits and designs iOS/macOS/watchOS/visionOS interfaces against the Apple Human Interface Guidelines, including the Liquid Glass design language') and when ('Use when reviewing an Apple-platform mockup or app for HIG compliance, checking contrast or tap-target sizes, or designing native-feeling Apple UI') with concrete quoted trigger phrases. Exact match for anchor 5; the 'when' clause is fully explicit, so this is not the anchor-4 case of a weakly specified 'when'.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage: 'HIG compliance', 'contrast', 'tap-target sizes', 'Liquid Glass', all four platform names, plus quoted example utterances users would actually say ('audit my iOS app against the HIG', 'is this text readable on Liquid Glass?'). Synonym-style variants ('reviewing', 'checking', 'auditing') are all present; nothing significant is missing that would drop it to 4.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Apple HIG / Liquid Glass / Apple platforms) with distinct triggers; uses third-person voice ('Audits and designs') as required. Overlap with generic UI-design skills is minimal because every trigger is platform- or HIG-scoped, matching the anchor-5 pattern rather than the 'minor overlap risk with closely related skills' of anchor 4.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 11 missing

Warning

Total

15

/

16

Passed

Repository
alirezarezvani/claude-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.