SwiftPM for macOS

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