Build, run, and test pure SwiftPM-based macOS packages and executables. Use when the repo is package-first, when there is no Xcode project, or when Swift package workflows are the fastest path to diagnosis.
Installs into .claude/skills of the current project.
Are you the author of Swiftpm Macos?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/kodik-ai-swiftpm-macos)
---
name: swiftpm-macos
description: Build, run, and test pure SwiftPM-based macOS packages and executables. Use when the repo is package-first, when there is no Xcode project, or when Swift package workflows are the fastest path to diagnosis.
---
# 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.
2. Build with SwiftPM.
- Use `swift build` by default.
- Use release mode only when the user explicitly needs it.
3. Run the right product.
- Use `swift run <product>` when an executable exists.
- If multiple executables exist, explain the default choice.
4. Test narrowly.
- Use `swift test`.
- Apply filters when a specific test target or case is known.
5. 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
