design-verify-ios

Validate iOS simulator screenshots against approved mockups to detect visual UI drift.

1|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/joi-fairshare/agentic-workflow --skill design-verify-ios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-verify-ios
Source: https://github.com/joi-fairshare/agentic-workflow/tree/main/skills/design-verify-ios
Command: npx skills add https://github.com/joi-fairshare/agentic-workflow --skill design-verify-ios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps implemented iOS screens synchronized with approved mockups by diffing simulator screenshots and surfacing visual drift before it reaches QA.

Core Features & Use Cases

  • Baseline discovery: Locates the latest mockup pngs for the requested screen and halts the workflow if none exist so you know to generate a baseline first.
  • Simulator orchestration: Acquires the shared simulator lock, boots the app via XcodeBuildMCP, navigates to the desired screen if requested, and captures the implementation screenshot.
  • Visual diff reporting: Runs the design-comparison MCP, classifies diffs by severity, and produces actionable discrepancy summaries with suggested fixes.
  • Use case: When designers approve a new onboarding screen, run this skill before QA to confirm colors, spacing, typography, and layout match the mockup before shipping.

Quick Start

Ask /design-verify-ios settings to capture the simulator screen and compare it to the approved mockup baseline.

Frequently Asked Questions about design-verify-ios

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

FAQPage Schema
How do I verify my iOS simulator screenshots match design mockups?

To verify iOS simulator screenshots match mockups, this skill captures the simulator state via xcodebuildmcp and compares it against stored baseline pngs using design-comparison diffs to detect visual drift.

What is iOS UI drift detection and how does screenshot diffing work?

iOS UI drift detection identifies visual discrepancies between implemented screens and approved mockups. Screenshot diffing captures the current simulator screen and compares pixel layouts, colors, and typography against baseline images to classify severity.

How do I capture an iOS simulator screenshot for mockup verification?

To capture an iOS simulator screenshot for mockup verification, the skill acquires a shared simulator lock, boots the Xcode app, optionally navigates to the desired screen, and captures the implementation screenshot for baseline comparison.

Does design-verify-ios work without approved mockup baselines?

Design-verify-ios does not work without approved mockup baselines. The baseline discovery process locates the latest mockup pngs for the requested screen and halts the workflow if none exist, ensuring you generate a baseline first.

Can I run screenshot comparison tests for Xcode apps before QA?

You can run screenshot comparison tests for Xcode apps before QA by capturing the simulator screen and comparing it to approved mockup baselines, producing actionable discrepancy summaries with suggested fixes before shipping.

Why does iOS simulator screenshot capture fail during design verification?

iOS simulator screenshot capture fails during design verification if the shared simulator lock cannot be acquired or if XcodeBuildMCP fails to boot the app, preventing the capture and comparison of the implementation screen.