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
- Sets up a self-signed code signing certificate (so permissions persist across rebuilds)
- Builds the app and test runner with that certificate
- Detects which TCC permissions the app needs
- Guides the user to grant each permission in System Settings
- Runs a smoke XCUITest to verify permissions work
- Reports pass/fail for each permission