Skip to main content
affpapa.org
RU EN
skill CX Codex GP ChatGPT official · OpenAI

swiftpm-macos — Codex skill: what it does, how to install

Builds, runs, and tests SwiftPM macOS packages and executables. Use it when Package.swift is the main entry point and no Xcode project is present.

Install into Codex · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add openai/plugins --skill swiftpm-macos -a codex
Open on GitHub

What swiftpm-macos does

The skill reads Package.swift first and identifies the package products: executables, libraries, and test targets. It then runs swift build; when an executable product exists, it uses swift run <product>. Release mode is reserved for an explicit request.

Testing uses swift test, with a filter when a specific target or test case is known. The agent reports the products it found, the commands it ran, and whether build, run, or test succeeded. Failures are grouped around module or import resolution, package dependencies, the linker, runtime behavior, or test regressions.

SwiftPM is preferred when the package path is simpler than Xcode. A library-only package cannot be run directly, so check its products before asking for a run.

What it helps with

  • build a package with SwiftPM
  • run an executable package product
  • narrow tests to a known case
  • trace a build failure to its source
  • inspect products declared in Package.swift

Example prompts for the agent

  • Inspect `Package.swift`, build the package, and report the products you find.
  • Run the right executable with `swift run <product>` and explain the choice if there is more than one.
  • Run `swift test`, identify the failure, and classify it as a dependency, linker, runtime, or test issue.

How to install swiftpm-macos

1Skills CLI (Vercel)

npx skills add openai/plugins --skill swiftpm-macos -a codex

2Manually: put the files in place

.agents/skills/swiftpm-macos/SKILL.md

For all projects use ~/.agents/skills/

From the same set201

The whole set →
supabase official supabase Guides the agent through database configuration and strict RLS policies in Supabase. CX Codex GP ChatGPT 8installs remotion-render official Remotion Exports videos and static stills from Remotion projects using CLI commands. CX Codex GP ChatGPT 3installs figma-create-new-file official Figma Creates blank Figma, FigJam, or Slides files inside draft folders. It resolves planKey and editor types before invoking Figma MCP tools. CX Codex GP ChatGPT 6installs swiftui-performance-audit official OpenAI Pinpoints SwiftUI runtime issues like frame drops, unresponsive taps, and excessive view body computations. Works code-first and guides Instruments profiling. CX Codex GP ChatGPT 109installs swiftui-liquid-glass official OpenAI This skill helps build and review SwiftUI Liquid Glass interfaces for iOS 26+. Use it when adopting the API or checking fallbacks, interaction, and design fit. CX Codex GP ChatGPT 121installs swiftui-ui-patterns official OpenAI This skill helps build and refactor SwiftUI interfaces, from navigation and state to layouts and controls. Use it for new screens or changes to an existing project. CX Codex GP ChatGPT 114installs swiftui-view-refactor official OpenAI Refactors SwiftUI view files into clean, testable structures with dedicated subview types and proper Observation ownership. CX Codex GP ChatGPT 113installs ios-memgraph-leaks official OpenAI Captures and inspects iOS leaks from a simulator process or .memgraph. Useful for tracing retained objects and checking a fix with before-and-after evidence. CX Codex GP ChatGPT 1,054installs

Similar

pester-should-migration official github Converts classic Pester v5 Should -Be assertions to the Pester v6 Should-Be syntax without spaces. Designed for modernizing PowerShell test suites. GitHub Copilot 19installs resx-source-generator-migration official github This skill moves a project from checked-in .Designer.cs files for .resx resources to a source generator. Use it when replacing the existing typed-resource generation setup. GitHub Copilot 10installs migrate-to-shoehorn Matt Pocock Replaces as type assertions in tests with helpers from @total-typescript/shoehorn. Use it when tests need partial objects or deliberately invalid data. Claude Code 475,388installs write-swift emilkowalski This skill guides Swift coding, reviews, and migrations using the language’s current practices. Use it to investigate concurrency errors, hangs, data races, or retain cycles. Claude Code CX Codex Cursor +1 117,500installs megacave JuliusBrussee Switches agent responses to Classical Chinese (wenyan) to reduce terminal output. Activated via /megacave or /caveman wenyan. Claude Code CX Codex Cursor +1 24,400installs find-docs upstash Pulls up-to-date documentation, API references and code examples for any library through the Context7 CLI. Useful when the model's training data lags behind the API. Claude Code CX Codex Cursor +1 9,400installs typescript-advanced-types Seth Hobson Guides an agent through advanced TypeScript types, from generics to conditional and mapped types. Use it for typed libraries, API clients, or strict configuration objects. Claude Code CX Codex Cursor 92,169installs smart-explore thedotmack Uses tree-sitter to map code structure and find symbols. Useful when you need to explore a codebase without loading every full file. Claude Code CX Codex Cursor +1 7,300installs

Questions about swiftpm-macos

How do I install swiftpm-macos in Codex?

Run npx skills add openai/plugins --skill swiftpm-macos, then npx skills add openai/plugins --skill swiftpm-macos -a codex. The skill file will be at .agents/skills/swiftpm-macos/SKILL.md.

What does swiftpm-macos do?

It inspects Package.swift, builds with swift build, runs an executable product with swift run <product>, and checks the package with swift test. It also explains the main blocker when a step fails.

Can it run a package that contains only libraries?

No. A library-only package has no product to run directly, and the skill calls this out when it inspects the package.

Source text

SKILL.md · MIT 
---
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

## 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

© OpenAI · MIT · openai/plugins

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor