macos-native-review

Evaluate macOS UI artifacts against Apple Human Interface Guidelines across 12 categories.

2|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Paretofilm/superpowers-gstack --skill macos-native-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-native-review
Source: https://github.com/Paretofilm/superpowers-gstack/tree/main/skills/macos-native-review
Command: npx skills add https://github.com/Paretofilm/superpowers-gstack --skill macos-native-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps ensure that artifacts intended for macOS read as native Mac applications, aligning with Apple Human Interface Guidelines to avoid iOS-like or cross-platform impressions.

Core Features & Use Cases

  • Evaluates PRDs, specs, and implementation plans for macOS-native surface patterns (menus, sheets, alerts, keyboard shortcuts) and flags deviations from HIG guidance.
  • Provides a structured, HIG-grounded verdict across the 12 categories (vocabulary, controls, keyboard shortcuts, colors, sheets/popovers/alerts, animation timing, permissions, accessibility, menu bar, app lifecycle, dock behavior, app menu).
  • Generates actionable fixes and citations to Apple HIG pages, to guide design and implementation teams before coding starts.

Quick Start

Run the macos-native-review skill on your PRD/spec for a macOS feature to verify native conformance against the Apple HIG.

Frequently Asked Questions about macos-native-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my macOS app conforms to Apple Human Interface Guidelines?

You can review macOS artifacts for HIG conformance by evaluating PRDs or specs across 12 categories including controls, keyboard shortcuts, sheets, and menu bar behavior, capturing evidence with citations and identifying gaps before implementation.

What is macOS native conformance review for UI surfaces?

A macOS native conformance review evaluates application artifacts against Apple Human Interface Guidelines to prevent iOS-like or cross-platform impressions by verifying menus, sheets, alerts, and animation timing match native Mac standards.

Can I review my pre-implementation macOS feature specs for native design gaps?

Yes, pre-implementation macOS feature specs can be reviewed to identify native design gaps by generating a structured evaluation across 12 HIG categories with concrete fixes anchored to spec sections and citations to Apple HIG pages.

When do I need a macOS HIG conformance review?

A macOS HIG conformance review is needed when you have PRDs or specs containing macOS UI surfaces, ensuring design and implementation teams receive actionable fixes and HIG citations before coding starts on Mac features.

What is the best way to ensure my Mac app doesn't feel like a cross-platform port?

The best way to avoid a cross-platform port impression is to compare Mac UI patterns against reference apps like Things or Raycast, verifying native conformance across vocabulary, permissions, dock behavior, and app lifecycle.

What are the 12 categories for evaluating macOS native conformance?

The 12 categories for evaluating macOS native conformance include vocabulary, controls, keyboard shortcuts, colors, sheets/popovers/alerts, animation timing, permissions, accessibility, menu bar, app lifecycle, dock behavior, and app menu.