Skills
.Work. You
Rest

swiftui-platform-rules

Official

macOS/iOS UI conventions and XCUITest reliability

Software Engineering#testing#accessibility#ios#macos#swiftui#ui-guidelines#xcuitest
Authorsmykla-skalski
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a concise, actionable set of platform conventions and UI testing patterns to prevent inconsistent macOS/iOS UI behavior and brittle XCUITest suites, reducing UI regressions and slow flaky tests.

Core Features & Use Cases

  • Platform Conventions: Defines menu order, traffic light placement, window chrome sizes, toolbar/sidebar placement, settings scene behavior, dock/notification expectations, and standard keyboard shortcuts for macOS and aspirational iOS guidance.
  • XCUITest Reliability: Prescribes animation suppression layers, mandatory use of .firstMatch, coordinate-based taps for non-hittable elements, single-launch test design, targeted wait strategies, and scroll helpers like dragUp.
  • Use Case: Use when implementing or reviewing macOS window/menu/toolbar/settings code or when authoring HarnessMonitorUITests to ensure consistent UX and fast, deterministic UI tests.

Quick Start

Apply these platform and XCUITest rules when reviewing or authoring macOS window, menu, toolbar, settings code or UI tests to enforce conventions and improve test reliability.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: swiftui-platform-rules
Download link: https://github.com/smykla-skalski/harness/archive/main.zip#swiftui-platform-rules

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.