design-verify

Detect web or iOS targets and delegate screenshot verification to the matching sub-skill.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents the user from having to choose between web and iOS workflows when comparing screenshots to mockups, so the delegation always lands on the correct verification pipeline.

Core Features & Use Cases

  • Automatic platform detection: runs globs for Package.swift, .xcodeproj/.xcworkspace plus package.json dependency checks to determine whether the repo is iOS, web, or both.
  • Delegated verification: forwards all arguments directly to /design-verify-web for Playwright diffs or /design-verify-ios for XcodeBuild diffs, keeping the downstream workflow consistent.
  • Fallback guidance: prompts the user whenever both platforms are present or none are detected, keeping verification on track for hybrid repos or ambiguous setups.

Quick Start

Ask the agent to run /design-verify current-screen so it detects the platform and delegates to the correct screenshot diff routine.

Frequently Asked Questions about design-verify

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

FAQPage Schema
How do I automate screenshot diff verification for both web and iOS mockups?

Automated screenshot diff verification detects your repository's platform by checking file globs and dependencies, then delegates to the matching Playwright or XcodeBuild pipeline for mockup comparison without manual selection.

How does automatic platform detection work for UI screenshot comparison?

Platform detection for UI screenshot comparison runs file glob checks for Package.swift, .xcodeproj, .xcworkspace, and package.json to determine whether your repository targets iOS, web, or both before delegating verification.

What happens if my repository contains both web and iOS code for design verification?

When both web and iOS platforms are detected during design verification, the system triggers an AskUserQuestion fallback to prompt you for manual platform selection, keeping the screenshot diff workflow on track for hybrid repos.

Can I use Playwright screenshot diffs without manually choosing the web pipeline?

Yes, Playwright screenshot diffs run automatically when web platform detection succeeds via package.json dependency inspection, forwarding all arguments directly to the web verification pipeline without manual platform selection.

Do I need XcodeBuild configured to run iOS mockup validation in an agentic workflow?

XcodeBuild configuration is required for iOS mockup validation, as the system delegates screenshot diff routines to the iOS verification pipeline only after detecting .xcodeproj or .xcworkspace files in your repository.

What are the limitations of automatic platform detection for design verification?

Automatic platform detection for design verification cannot proceed autonomously when no platform files are found or when both web and iOS setups exist, requiring user input via AskUserQuestion fallbacks to resolve ambiguous repository configurations.