How do I install the Preview Build skill?

Run npx skillmds@latest add tomevault-io/preview-build in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Preview Build safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Preview Build?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Preview Build free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Preview Build?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Preview Build by tomevault-io — Agent Skill

Name: Preview Build
Author: tomevault-io

Preview Build

Build and capture SwiftUI previews for visual analysis. Use when the user asks to preview a SwiftUI view, capture a simulator screenshot, or visually inspect iOS UI components. Supports Xcode projects, SPM packages, and standalone Swift files. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Xcode Preview Capture Skill

Build SwiftUI views and capture screenshots of their rendered output for visual analysis.

Installation Path

Scripts are located at ${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}/scripts/

Compatibility: If ~/XcodePreviews doesn't exist, fall back to ~/Claude-XcodePreviews (legacy name). The PREVIEW_BUILD_PATH environment variable overrides both.

Available Commands

Unified Preview (Recommended)

Auto-detects project type and uses the best approach:

"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Quick Capture (Current Simulator)

"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/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):

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

SPM Package Preview

Auto-detected from Package.swift in parent directories:

"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Standalone Swift File

Build a standalone Swift file with system frameworks only:

"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \
  <path-to-file.swift> \
  --output /tmp/preview.png

Workflow

When the user asks to preview a SwiftUI view:

Identify the target: Determine what needs to be previewed (Swift file, project scheme, or current simulator state)
Build and capture: Run the appropriate script
Read and analyze: Use the Read tool to view the captured PNG at /tmp/preview.png
Report findings:
- Layout: Structure and arrangement
- Visual elements: Buttons, text, images
- Styling: Colors, fonts, spacing
- Issues: Alignment, overflow, accessibility
- Suggestions: Improvements

Parameters

Option	Description
`--project <path>`	Xcode project file
`--workspace <path>`	Xcode workspace file
`--package <path>`	SPM Package.swift path
`--module <name>`	Target module (auto-detected)
`--simulator <name>`	Simulator name (default: iPhone 17 Pro)
`--output <path>`	Output screenshot path
`--verbose`	Show detailed build output

Error Handling

No simulator booted: Run sim-manager.sh boot "iPhone 17 Pro"
Build failure: Show error, suggest fixes, offer to retry
Resource bundle crash: The dynamic script auto-includes Tuist and common bundle patterns
Missing imports: Check if the target module needs to be added to imports

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: preview-builddescription: Build and capture SwiftUI previews for visual analysis. Use when the user asks to preview a SwiftUI view, capture a simulator screenshot, or visually inspect iOS UI components. Supports Xcode projects, SPM packages, and standalone Swift files. Use when this capability is needed.---# Xcode Preview Capture SkillBuild SwiftUI views and capture screenshots of their rendered output for visual analysis.## Installation PathScripts are located at `${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}/scripts/`> **Compatibility:** If `~/XcodePreviews` doesn't exist, fall back to `~/Claude-XcodePreviews` (legacy name). The `PREVIEW_BUILD_PATH` environment variable overrides both.## Available Commands### Unified Preview (Recommended)Auto-detects project type and uses the best approach:```bash"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \ <path-to-file.swift> \ --output /tmp/preview.png```### Quick Capture (Current Simulator)```bash"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/capture-simulator.sh \ --output /tmp/preview-capture.png```### Xcode Project with #PreviewFast builds by injecting a minimal PreviewHost target (handled automatically by the unified script):```bash"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \ <path-to-file.swift> \ --project <path.xcodeproj> \ --output /tmp/preview.png```### SPM Package PreviewAuto-detected from Package.swift in parent directories:```bash"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \ <path-to-file.swift> \ --output /tmp/preview.png```### Standalone Swift FileBuild a standalone Swift file with system frameworks only:```bash"${PREVIEW_BUILD_PATH:-$HOME/XcodePreviews}"/scripts/preview \ <path-to-file.swift> \ --output /tmp/preview.png```## WorkflowWhen the user asks to preview a SwiftUI view:1. **Identify the target**: Determine what needs to be previewed (Swift file, project scheme, or current simulator state)2. **Build and capture**: Run the appropriate script3. **Read and analyze**: Use the Read tool to view the captured PNG at `/tmp/preview.png`4. **Report findings**: - **Layout**: Structure and arrangement - **Visual elements**: Buttons, text, images - **Styling**: Colors, fonts, spacing - **Issues**: Alignment, overflow, accessibility - **Suggestions**: Improvements## Parameters| Option | Description ||--------|-------------|| `--project <path>` | Xcode project file || `--workspace <path>` | Xcode workspace file || `--package <path>` | SPM Package.swift path || `--module <name>` | Target module (auto-detected) || `--simulator <name>` | Simulator name (default: iPhone 17 Pro) || `--output <path>` | Output screenshot path || `--verbose` | Show detailed build output |## Error Handling- **No simulator booted**: Run `sim-manager.sh boot "iPhone 17 Pro"`- **Build failure**: Show error, suggest fixes, offer to retry- **Resource bundle crash**: The dynamic script auto-includes Tuist and common bundle patterns- **Missing imports**: Check if the target module needs to be added to imports---> Converted and distributed by [TomeVault](https://tomevault.io/claim/iron-ham) — claim your Tome and manage your conversions.

Frequently asked questions