Skip to content
cccskills
FreePublished on GitHub

xcode-preview-capture

Build and capture Xcode/SwiftUI previews for visual analysis. Use when you need to see rendered UI output, verify layouts, or inspect visual components.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection
See how to install

Files included (1)

  • SKILL.md3.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Overview

This skill allows you to build SwiftUI views and capture screenshots of their rendered output for visual analysis. It supports:

  • Building standalone Swift files containing SwiftUI views
  • Building views from existing Xcode projects
  • Building views from SPM packages
  • Capturing the current simulator screen
  • Analyzing the captured screenshots

Installation Path

Scripts are located at ${CLAUDE_PLUGIN_ROOT}/scripts/

Available Commands

Unified Preview (Recommended)

Auto-detects project type and uses the best approach:

"${CLAUDE_PLUGIN_ROOT}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Quick Capture (Current Simulator)

Capture a screenshot of whatever is currently displayed on the booted simulator.

"${CLAUDE_PLUGIN_ROOT}"/scripts/capture-simulator.sh \
  --output /tmp/preview-capture.png

Xcode Project with #Preview

Fast builds by injecting a minimal PreviewHost target (handled automatically by the unified script):

"${CLAUDE_PLUGIN_ROOT}"/scripts/preview \
  <path-to-file.swift> \
  --project <path.xcodeproj> \
  --output /tmp/preview.png

SPM Package Preview

Auto-detected from Package.swift in parent directories:

"${CLAUDE_PLUGIN_ROOT}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Standalone Swift File

Build a standalone Swift file with system frameworks only:

"${CLAUDE_PLUGIN_ROOT}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Workflow

When the user invokes /preview, follow this workflow:

  1. Identify the target: Determine what needs to be previewed:

    • A specific Swift file
    • An Xcode project/workspace with a scheme
    • The current simulator state

  2. Build and capture: Use the appropriate script based on the target

  3. Read and analyze: Use the Read tool to view the captured PNG image

  4. Report findings: Describe what you see in the preview, including:

    • Layout and structure
    • Colors and styling
    • Any potential issues (alignment, overflow, etc.)
    • Suggestions for improvement

Parameters

The user can specify:

  • file: Path to a Swift file to preview
  • project: Path to an Xcode project
  • workspace: Path to an Xcode workspace
  • scheme: Build scheme name
  • simulator: Simulator to use (default: "iPhone 17 Pro")
  • wait: Seconds to wait before capture (default: 3)

Example Usage

User: /preview ContentView.swift
User: /preview --project MyApp.xcodeproj --scheme MyApp
User: /preview --capture-only

Error Handling

If the build fails:

  1. Show the build error output
  2. Suggest fixes based on the error messages
  3. Offer to try again after fixes are applied

If no simulator is booted:

  1. List available simulators
  2. Offer to boot one

Output

After capturing, always:

  1. Confirm the screenshot was saved
  2. Read the image using the Read tool
  3. Provide analysis of what's visible

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ab-test-store-listing

Free

When the user wants to A/B test App Store product page elements to improve conversion rate. Also use when the user mentions "A/B test", "product page optimization", "test my screenshots", "test my icon", "conversion rate optimization", "CPP", or "custom product pages". For screenshot design, see screenshot-optimization. For metadata optimization, see metadata-optimization.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

accessorysetupkit

Free

Discover and configure Bluetooth and Wi-Fi accessories using AccessorySetupKit. Use when presenting a privacy-preserving accessory picker, defining discovery descriptors for BLE or Wi-Fi devices, handling accessory session events, migrating from CoreBluetooth permission-based scanning, or setting up accessories without requiring broad Bluetooth permissions.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

activitykit

Free

Implement, review, or improve Live Activities and Dynamic Island experiences in iOS apps using ActivityKit. Use when building real-time updating widgets for the Lock Screen and Dynamic Island — delivery tracking, sports scores, ride-sharing status, workout timers, media playback, or any time-sensitive information that updates in real time. Also use when working with ActivityKit, ActivityAttributes, Activity lifecycle (request/update/end), Dynamic Island layouts (compact/minimal/expanded), push-to-update Live Activities, or Lock Screen live widgets.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

adattributionkit

Free

Measure ad effectiveness with privacy-preserving attribution using AdAttributionKit. Use when registering ad impressions, handling attribution postbacks, updating conversion values, implementing re-engagement attribution, configuring publisher or advertiser apps, or replacing SKAdNetwork with AdAttributionKit for ad measurement.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

alarmkit

Free

Implement AlarmKit alarms and countdown timers for iOS and iPadOS with Lock Screen, Dynamic Island, and Apple Watch system UI. Covers AlarmManager scheduling, AlarmAttributes and AlarmPresentation, AlarmButton stop and snooze actions, authorization, state observation, and Live Activity integration. Use when building wake-up alarms, countdown timers, or alarm-style alerts that need Apple's system alarm experience.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

android-aso

Free

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

The English summary is being prepared. Showing the original description.

JordanCoin/ios-skills-collection6Updated Sep 10, 2026

See all skills by JordanCoin

Report a problem with this skill