agentleFS
jhonatan-oliveiradevjhonatan-oliveiradev/agent-skills/skills/reviewing-apple-platform-interfaces/SKILL.md

reviewing-apple-platform-interfaces

Skill1 starsChanged 3 months agoMITView on GitHub

Use when reviewing or refining an iOS, iPadOS, or macOS app interface against current Apple Human Interface Guidelines, including native, Flutter, React Native, Tauri, or Electron implementations.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Verify accessibility using evidence: screen-reader labels and order, dynamic text sizing, readable contrast from source colors, keyboard …

    line 17

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Reviewing Apple Platform Interfaces

Scope

Review an app for the Apple platforms it actually targets. Apply Apple platform conventions to iOS, iPadOS, and macOS apps; apply only transferable accessibility and design principles to a website. Do not treat an Apple-inspired appearance as a requirement to imitate system controls. This method evaluates an existing experience; use designing-ui-systems to establish a reusable design system or auditing-pixel-perfect-frontend to compare implementation against an approved reference.

Review workflow

  1. Identify the platform, framework, audience, screen's job, and available evidence: running app, code, video, screenshot, or design file. Record which interactions and states cannot be observed. Review both compact and expanded layouts when the app supports them.
  2. Open the current Apple Human Interface Guidelines through the topic map. Read the platform overview, accessibility, layout, and the pages for controls and flows actually present. Use the page's current guidance rather than recalled numbers or bundled excerpts. If a page is unavailable, mark its requirements unverified.
  3. Walk the task from entry to completion. Check navigation, control placement, labels, focus and input, empty/loading/error states, destructive actions, undo and permission timing. On mobile, inspect safe areas, text enlargement, orientation and accessible touch interaction. On macOS, inspect window resizing, keyboard, menus and pointer behavior. Translate a platform behavior into the actual framework's capabilities before prescribing code.
  4. Verify accessibility using evidence: screen-reader labels and order, dynamic text sizing, readable contrast from source colors, keyboard access when applicable, motion settings and alternate appearance. Measure numeric claims from real values or a running UI; a screenshot alone does not establish compliance.
  5. Separate a platform convention from a design preference. Keep the product's own type, color and visual character where platform behavior permits. Diagnose whether the interface communicates the task clearly before recommending decorative changes.
  6. Prioritize fixes by impact and confidence. For each finding include the observed behavior, location, relevant Apple page and heading or principle, why it applies to this platform, a concrete change in the user's framework, and a verification step. State uncertainty when source or behavior cannot be checked.

Result

Provide a short assessment, then actionable findings ordered by severity: blocked task or accessibility, confusing platform behavior, and polish. Include what already works and what remains unverified. Link to the relevant official guideline for each platform-specific claim. Do not describe a design as Apple-certified, officially endorsed, or fully compliant on the basis of a static review.

Boundary

Apple updates its guidance. Do not copy or redistribute its pages as part of this skill, and do not assert fixed values such as contrast thresholds or minimum target sizes without verifying the applicable current source and context. For Android or general web apps, avoid imposing iOS or macOS navigation and material conventions unless the user's product explicitly requires them.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.