Labsco
openai logo

swiftpm-macos

✓ Official4,000

by 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…

🔥🔥🔥✓ VerifiedFreeQuick setup
🧩 One of 7 skills in the openai/plugins package — works on its own, and pairs well with its siblings.

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

  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