macOS SwiftPM Runner

Quick Start

Use this skill when Package.swift is the primary entrypoint or when SwiftPM is the fastest path to a reproducible result.

Workflow

1. Inspect the package.

• Read Package.swift.
• Identify executable, library, and test products.

1. Build with SwiftPM.

• Use swift build by default.
• Use release mode only when the user explicitly needs it.

1. Run the right product.

• Use swift run <product> when an executable exists.
• If multiple executables exist, explain the default choice.

1. Test narrowly.

• Use swift test.
• Apply filters when a specific test target or case is known.

1. Summarize failures.

• Module/import resolution
• Package graph or dependency issue
• Linker failure
• Runtime failure
• Test regression

Guardrails

• Prefer SwiftPM over Xcode when both exist and the package path is clearly simpler.
• Do not assume an app bundle exists in a pure package workflow.
• Explain when the package is library-only and therefore not directly runnable.

Output Expectations

Provide:

• the package products you found
• the command you ran
• whether build, run, or test succeeded
• the top blocker if not