# Test Macos App

> Slash command that runs the smallest meaningful macOS test scope first and explains failures by category. Invoke explicitly with /test-macos-app — this skill never self-triggers.

- Skill: `1c7/test-macos-app` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 1c7/test-macos-app`
- Raw SKILL.md: https://api.skillmd.com/api/skills/1c7/test-macos-app/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 1c7 (https://skillmd.com/u/1c7)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/1c7/test-macos-app

---


# Test macOS App

Run the smallest meaningful macOS test scope first and explain failures by category.

## Arguments

- `scheme`: Xcode scheme name (optional)
- `target`: test target or product name (optional)
- `filter`: test filter expression (optional)
- `configuration`: `Debug` or `Release` (optional, default: `Debug`)

## Workflow

1. Detect whether the repo uses `xcodebuild test` or `swift test`.
2. Prefer focused test execution when a target or filter is provided.
3. Classify failures as compile, assertion, crash, env/setup, or flake.
4. Summarize the top blocker and the narrowest sensible next step.

## Guardrails

- Avoid rerunning the full suite if a focused rerun is possible.
- Distinguish build failures from actual failing tests.
- Note when host app setup or simulator-only test assumptions leak into a macOS run.