preflight-permissions

Installation
SKILL.md

Preflight Permissions

Ensure all macOS system permissions are granted before automated UI tests run. This prevents XCUITests from hanging on permission dialogs or failing silently when TCC blocks access.

When to Use

Run this skill once when starting a new project, after cloning, or whenever tests fail with permission-related errors. It is a prerequisite for journey-builder and journey-loop.

What It Does

  1. Sets up a self-signed code signing certificate (so permissions persist across rebuilds)
  2. Builds the app and test runner with that certificate
  3. Detects which TCC permissions the app needs
  4. Guides the user to grant each permission in System Settings
  5. Runs a smoke XCUITest to verify permissions work
  6. Reports pass/fail for each permission
Related skills
Installs
1
First Seen
Mar 28, 2026