macos-e2e-scaffold

Audit macOS SwiftUI projects and scaffold XCUITest infrastructure with test stubs.

2|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Paretofilm/superpowers-gstack --skill macos-e2e-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-e2e-scaffold
Source: https://github.com/Paretofilm/superpowers-gstack/tree/main/skills/macos-e2e-scaffold
Command: npx skills add https://github.com/Paretofilm/superpowers-gstack --skill macos-e2e-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits macOS SwiftUI projects to automatically scaffold XCUITest infrastructure, rank top views by interactive control density, and emit a Claude-readable xcresult runner script. Manual invocation only — modifies project files.

Core Features & Use Cases

  • Audits the project to enumerate SwiftUI scenes and identify top views by interactive-control density.
  • Suggests accessibility identifiers for the most important controls and batch-applies them after user confirmation.
  • Generates ranked test stubs for Smoke, Happy-Path, and Error-Recovery scenarios, plus optional modals/menus when detected.
  • Emits a Claude-readable xcresult runner script to run tests and export results.
  • Prevents overwriting existing UI test targets; instructs how to extend manually if needed.

Quick Start

Run the macos-e2e-scaffold skill on a macOS SwiftUI project to generate the UI test scaffolds and runner script.

Frequently Asked Questions about macos-e2e-scaffold

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

FAQPage Schema
How do I scaffold XCUITest infrastructure for a macOS SwiftUI app?

Scaffolding XCUITest infrastructure for a macOS SwiftUI app involves auditing WindowGroup-based scenes, ranking views by interactive controls, and generating test stubs with accessibility identifiers. This process creates a ready-to-run test suite and a Claude-readable runner script.

How does automated E2E testing handle accessibility identifiers in SwiftUI views?

Automated E2E testing audits SwiftUI views to suggest accessibility identifiers for important controls, then batch-applies them after user confirmation. This ensures interactive elements are properly identified for XCUITest execution without manual coding errors.

Can I generate UI test stubs for SwiftUI projects using Swift Package Manager?

Yes, you can generate UI test stubs for SwiftUI projects using Swift Package Manager. The scaffolding process detects the project type, whether xcodegen, SPM, or plain, and adapts the XCUITest infrastructure generation accordingly without manual configuration.

What is the best way to rank SwiftUI views for automated UI testing?

The best way to rank SwiftUI views for automated UI testing is by evaluating interactive control density. The scaffolding process enumerates scenes and prioritizes views with the highest concentration of interactive elements for targeted test stub generation.

Why does the XCUITest scaffolding process require manual invocation on macOS projects?

XCUITest scaffolding requires manual invocation because it modifies project files directly. This prevents accidental overwrites of existing UI test targets and ensures developers intentionally confirm accessibility identifier batch-applies before execution.

Does the XCUITest scaffolding overwrite existing UI test targets in a SwiftUI project?

No, the XCUITest scaffolding does not overwrite existing UI test targets in a SwiftUI project. It detects existing tests and instructs developers on how to extend the infrastructure manually to preserve current test coverage.