Skill

preview-report

Captures screenshots of #Preview blocks in multiple SwiftUI files and generates Markdown visual reports with images. Useful for PR reviews, batch UI checks, and visual regression testing.

Swift

iOS

npx claudepluginhub k-kohey/axe --plugin axe-preview

Tool Access

This skill is limited to using the following tools:

Bash(axe *)Bash(cat *)Bash(git diff *)ReadGlobGrep

Preview

Capture screenshots of all `#Preview` blocks across multiple SwiftUI files and generate a report.

SKILL.md

Similar Skills

preview

Captures screenshots of SwiftUI #Preview blocks using axe CLI. Visualize View appearance, check layouts, and verify visual changes.

3 tools

axe-preview

Xcode Preview Capture Skill

130

Builds and captures screenshots of SwiftUI previews from standalone files, Xcode projects, SPM packages, or running simulators for visual UI analysis.

preview-build

claude-design-to-swiftui

Converts Claude HTML/CSS prototypes (via design URL or .tar.gz) to single self-contained SwiftUI View files in active Xcode workspaces. Generates code, builds, previews, and visually diffs for layout fidelity.

15 files

claudedesign-to-swiftui

Stats

Parent Repo Stars34

Parent Repo Forks3

Last CommitFeb 28, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Batch Preview Report

Capture screenshots of all #Preview blocks across multiple SwiftUI files and generate a report.

Steps

1. Determine target files

If $ARGUMENTS specifies files, use those directly. $ARGUMENTS may contain only View names (e.g. ContentView) instead of file paths, so resolve each to a .swift path (e.g. TodoApp/ContentView.swift) using Glob.

If no arguments are provided, detect changed Swift files:

FILES=$(git diff --name-only --diff-filter=ACMR HEAD -- '*.swift')
if [ -z "$FILES" ]; then
  echo "No changed Swift files found. Specify files explicitly."
  exit 1
fi

2. Generate the report

axe preview report $FILES --format md --output <output-dir>

When $ARGUMENTS is provided, use $ARGUMENTS instead of $FILES:

axe preview report $ARGUMENTS --format md --output <output-dir>

This generates:

axe_swiftui_preview_report.md — Markdown report with embedded image references
axe_swiftui_preview_report_assets/*.png — Individual preview screenshots

3. Display the results

Read the generated Markdown report with the Read tool. Then read each preview image in the assets directory to show them to the user.

4. Summarize

Provide a summary of all captured previews, noting:

Total number of #Preview blocks found
Any previews that failed to capture (and likely reasons from stderr)
Quick observations about the UI state of each view

Options

Use -j <n> to control parallel simulator count for faster capture
Use --reuse-build to skip rebuilding if the project was recently built
Replace --format md with --format html for an interactive HTML report with lightbox

Use Cases

PR review: Capture all changed views before creating a pull request
Visual regression: Compare previews across branches
Documentation: Generate a visual catalog of UI components

Prerequisites

Run this if the command fails because axe is not found::

curl -fsSL https://raw.githubusercontent.com/k-kohey/axe/main/install.sh | sh