
swiftpm-macos
✓ Official★ 4,000by openai · part of openai/plugins
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…
This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.
name: swiftpm-macos description: Build, run, and test SwiftPM macOS packages and executables. Use when the repo is package-first or has no Xcode project.
SwiftPM for macOS
Workflow
-
Inspect the package.
- Read
Package.swift. - Identify executable, library, and test products.
- Read
-
Build with SwiftPM.
- Use
swift buildby default. - Use release mode only when the user explicitly needs it.
- Use
-
Run the right product.
- Use
swift run <product>when an executable exists. - If multiple executables exist, explain the default choice.
- Use
-
Test narrowly.
- Use
swift test. - Apply filters when a specific test target or case is known.
- Use
-
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
npx skills add https://github.com/openai/plugins --skill swiftpm-macosRun this in your project — your agent picks the skill up automatically.
Quick Start
Use this skill when Package.swift is the primary entrypoint or when SwiftPM is
the fastest path to a reproducible result.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.