Agent Skills › robinebers/openusage › macos-swiftpm

macos-swiftpm

GitHub

针对 macOS 平台的 SwiftPM 包管理技能，用于在缺乏 Xcode 项目时通过 Package.swift 快速构建、运行及测试 Swift 包和可执行文件。

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

Trigger Scenarios

用户需要构建或运行 Swift 包仓库以 Package.swift 为主入口且无 Xcode 项目

Install

npx skills add robinebers/openusage --skill macos-swiftpm -g -y

More Options

Non-standard path

npx skills add https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-swiftpm -g -y

Use without installing

npx skills use robinebers/openusage@macos-swiftpm

指定 Agent (Claude Code)

npx skills add robinebers/openusage --skill macos-swiftpm -a claude-code -g -y

安装 repo 全部 skill

npx skills add robinebers/openusage --all -g -y

预览 repo 内 skill

npx skills add robinebers/openusage --list

SKILL.md

Frontmatter

{
    "name": "macos-swiftpm",
    "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

Inspect the package.
- Read Package.swift.
- Identify executable, library, and test products.
Build with SwiftPM.
- Use swift build by default.
- Use release mode only when the user explicitly needs it.
Run the right product.
- Use swift run <product> when an executable exists.
- If multiple executables exist, explain the default choice.
Test narrowly.
- Use swift test.
- Apply filters when a specific test target or case is known.
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.