New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

macOS Spm App Packaging

by Dimillian in Dimillian/Skills

Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

MITAuto-check passedMobile

Install macOS Spm App Packaging

skills CLI
$ npx skills add Dimillian/Skills --skill macos-spm-app-packaging -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Dimillian/Skills macos-spm-app-packaging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Dimillian/Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/macos-spm-app-packaging .claude/skills/macos-spm-app-packaging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
macos-spm-app-packaging
GitHub stars
4k
Used in
5 other repos
Token cost
~1.2k tokens
SKILL.md length
405 words
Files
18 (incl. references, assets)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

  • Works in 2 steps: Bootstrap the project folder → Build, package, and run the bootstrapped…
  • You need a from-scratch macOS app layout
  • SKILL.md covers Overview, Two-Step Workflow, Minimum End-to-End Example and Validation Checkpoints, plus 3 more sections
  • Runs Shell and Swift scripts from its folder; calls swift and xcrun

What it does

macOS Spm App Packaging is an agent skill from Dimillian/Skills. Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project. Use when you need a from-scratch macOS app layout, SwiftPM targets/resources, a custom .app bundle assembly script, or signing/notarization/appcast steps outside Xcode.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 24 other files, including reference files and assets (for example `agents/openai.yaml`, `assets/templates/build_icon.sh` and `assets/templates/compile_and_run.sh`).

It sits in Mobile, covering iOS development. It works with macOS, Xcode and Swift. The licence is MIT.

When your agent uses it

  • You need a from-scratch macOS app layout
  • SwiftPM targets/resources
  • A custom .app bundle assembly script
  • Signing/notarization/appcast steps outside Xcode

Example prompts

  • “/macos-spm-app-packaging”

Requirements

  • A Bash shell

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Bootstrap the project folder
  2. Build, package, and run the bootstrapped app

What it can do on your machine

Read from SKILL.md and the folder at commit 05ba982. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell and Swift, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • swift
    • xcrun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

macOS Spm App Packaging loads about 1.2k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 405 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Dimillian/Skills at commit 05ba982, republished under its MIT licence (© Dimillian). 405 words, ~1,213 tokens.

Download SKILL.mdSave it as .claude/skills/macos-spm-app-packaging/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
macos-spm-app-packaging
description
Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project. Use when you need a from-scratch macOS app layout, SwiftPM targets/resources, a custom .app bundle assembly script, or signing/notarization/appcast steps outside Xcode.

macOS SwiftPM App Packaging (No Xcode)

Overview

Bootstrap a complete SwiftPM macOS app folder, then build, package, and run it without Xcode. Use assets/templates/bootstrap/ for the starter layout and references/packaging.md + references/release.md for packaging and release details.

Two-Step Workflow

  1. Bootstrap the project folder

    • Copy assets/templates/bootstrap/ into a new repo.
    • Rename MyApp in Package.swift, Sources/MyApp/, and version.env.
    • Customize APP_NAME, BUNDLE_ID, and versions.

  2. Build, package, and run the bootstrapped app

    • Copy scripts from assets/templates/ into your repo (for example, Scripts/).
    • Build/tests: swift build and swift test.
    • Package: Scripts/package_app.sh.
    • Run: Scripts/compile_and_run.sh (preferred) or Scripts/launch.sh.
    • Release (optional): Scripts/sign-and-notarize.sh and Scripts/make_appcast.sh.
    • Tag + GitHub release (optional): create a git tag, upload the zip/appcast to the GitHub release, and publish.

Minimum End-to-End Example

Shortest path from bootstrap to a running app:

bash
# 1. Copy and rename the skeleton
cp -R assets/templates/bootstrap/ ~/Projects/MyApp
cd ~/Projects/MyApp
sed -i '' 's/MyApp/HelloApp/g' Package.swift version.env

# 2. Copy scripts
cp assets/templates/package_app.sh Scripts/
cp assets/templates/compile_and_run.sh Scripts/
chmod +x Scripts/*.sh

# 3. Build and launch
swift build
Scripts/compile_and_run.sh

Validation Checkpoints

Run these after key steps to catch failures early before proceeding to the next stage.

After packaging (Scripts/package_app.sh):

bash
# Confirm .app bundle structure is intact
ls -R build/HelloApp.app/Contents

# Check that the binary is present and executable
file build/HelloApp.app/Contents/MacOS/HelloApp

After signing (Scripts/sign-and-notarize.sh or ad-hoc dev signing):

bash
# Inspect signature and entitlements
codesign -dv --verbose=4 build/HelloApp.app

# Verify the bundle passes Gatekeeper checks locally
spctl --assess --type execute --verbose build/HelloApp.app

After notarization and stapling:

bash
# Confirm the staple ticket is attached
stapler validate build/HelloApp.app

# Re-run Gatekeeper to confirm notarization is recognised
spctl --assess --type execute --verbose build/HelloApp.app

Common Notarization Failures

SymptomLikely CauseRecovery
The software asset has already been uploadedDuplicate submission for same versionBump BUILD_NUMBER in version.env and repackage.
Package Invalid: Invalid Code Signing EntitlementsEntitlements in .entitlements file don't match provisioningAudit entitlements against Apple's allowed set; remove unsupported keys.
The executable does not have the hardened runtime enabledMissing --options runtime flag in codesign invocationEdit sign-and-notarize.sh to add --options runtime to all codesign calls.
Notarization hangs / no status emailxcrun notarytool network or credential issueRun xcrun notarytool history to check status; re-export App Store Connect API key if expired.
stapler validate fails after successful notarizationTicket not yet propagatedWait ~60 s, then re-run xcrun stapler staple.
Show full SKILL.md (132 more words)Show less

Templates

  • assets/templates/package_app.sh: Build binaries, create the .app bundle, copy resources, sign.
  • assets/templates/compile_and_run.sh: Dev loop to kill running app, package, launch.
  • assets/templates/build_icon.sh: Generate .icns from an Icon Composer file (requires Xcode install).
  • assets/templates/sign-and-notarize.sh: Notarize, staple, and zip a release build.
  • assets/templates/make_appcast.sh: Generate Sparkle appcast entries for updates.
  • assets/templates/setup_dev_signing.sh: Create a stable dev code-signing identity.
  • assets/templates/launch.sh: Simple launcher for a packaged .app.
  • assets/templates/version.env: Example version file consumed by packaging scripts.
  • assets/templates/bootstrap/: Minimal SwiftPM macOS app skeleton (Package.swift, Sources/, version.env).

Notes

  • Keep entitlements and signing configuration explicit; edit the template scripts instead of reimplementing.
  • Remove Sparkle steps if you do not use Sparkle for updates.
  • Sparkle relies on the bundle build number (CFBundleVersion), so BUILD_NUMBER in version.env must increase for each update.
  • For menu bar apps, set MENU_BAR_APP=1 when packaging to emit LSUIElement in Info.plist.

© Dimillian, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (references, assets) in macos-spm-app-packaging of Dimillian/Skills.

  • SKILL.md
  • agents/openai.yaml
  • assets/templates/bootstrap/Package.swift
  • assets/templates/bootstrap/Sources/MyApp/Resources/.keep
  • assets/templates/bootstrap/Sources/MyApp/main.swift
  • assets/templates/bootstrap/version.env
  • assets/templates/build_icon.sh
  • assets/templates/compile_and_run.sh
  • assets/templates/launch.sh
  • assets/templates/make_appcast.sh
  • assets/templates/package_app.sh
  • assets/templates/setup_dev_signing.sh
  • assets/templates/sign-and-notarize.sh
  • assets/templates/version.env
  • … and 4 more

Open the folder on GitHubat commit 05ba982

Used in 5 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in Dimillian/Skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

macOS Spm App Packaging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

macOS Spm App Packaging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
macOS Spm App Packaging this skillDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Build Run Debugrobinebers/openusage4.3k—~1.8kAutomated safety check: PassMIT
Bootstrap iOSRayFernando1337/rayfernando-skills130—~1.1kAutomated safety check: PassApache-2.0
macOS Build Run Debugrobinebers/openusage4.3k—~1.8kAutomated safety check: PassMIT
macOS Swiftpmrobinebers/openusage4.3k—~344Automated safety check: PassMIT
macOS Test Triagerobinebers/openusage4.3k—~393Automated safety check: PassMIT

Similar skills

  • Build Run Debug

    robinebers/openusage

    Build, run, and debug local macOS apps and desktop executables using shell-first Xcode and Swift workflows.

    4.3k GitHub stars~1.8k tokensUpdated 3 days ago
    MobileAuto-check passed

  • Bootstrap iOS

    RayFernando1337/rayfernando-skills

    Bootstrap agents for iOS, iPadOS, macOS, Swift, SwiftUI, SwiftData/Core Data, Swift Testing, Xcode build/test/debug, Simulator, App Intents, or XcodeBuildMCP work.

    130 GitHub stars~1.1k tokensUpdated 2 mo ago
    MobileAuto-check passed

  • macOS Build Run Debug

    robinebers/openusage

    Build, run, and debug macOS apps with shell-first Xcode and Swift workflows.

    4.3k GitHub stars~1.8k tokensUpdated 3 days ago
    MobileAuto-check passed

  • macOS Swiftpm

    robinebers/openusage

    Build, run, and test SwiftPM macOS packages and executables.

    4.3k GitHub stars~344 tokensUpdated 3 days ago
    MobileAuto-check passed

  • macOS Test Triage

    robinebers/openusage

    Triage macOS tests across Xcode and SwiftPM. An agent skill from robinebers/openusage.

    4.3k GitHub stars~393 tokensUpdated 3 days ago
    MobileAuto-check passed

  • Test Triage

    robinebers/openusage

    Triage failing macOS tests across Xcode and SwiftPM workflows.

    4.3k GitHub stars~412 tokensUpdated 3 days ago
    MobileAuto-check passed

More from Dimillian/Skills

All 12 skills in this repo

  • React Component Performance

    Dimillian/Skills

    Analyze and optimize React component performance issues (slow renders, re-render thrash, laggy lists, expensive computations).

    4k GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed

  • Swiftui View Refactor

    Dimillian/Skills

    Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.

    4k GitHub starsUsed in 5 repos~2k tokens
    Auto-check passed

  • Swiftui UI Patterns

    Dimillian/Skills

    Best practices and example-driven guidance for building SwiftUI views and components, including navigation hierarchies, custom view modifiers, and responsive layouts with stacks and grids.

    4k GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed

  • Swift Concurrency Expert

    Dimillian/Skills

    Swift Concurrency review and remediation for Swift 6.2+. An agent skill from Dimillian/Skills.

    4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed

  • GitHub

    Dimillian/Skills

    Interact with GitHub using the gh CLI. An agent skill from Dimillian/Skills.

    4k GitHub stars~480 tokensUpdated 6 mo ago
    Auto-check passed

  • macOS Menubar Tuist App

    Dimillian/Skills

    Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI.

    4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Categories

Questions about macOS Spm App Packaging

What does macOS Spm App Packaging do?

Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project. macOS Spm App Packaging is an agent skill from Dimillian/Skills. Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

When should I use macOS Spm App Packaging?

macOS Spm App Packaging fits situations like: you need a from-scratch macOS app layout; swiftPM targets/resources; A custom .app bundle assembly script; signing/notarization/appcast steps outside Xcode.

How do I install macOS Spm App Packaging in Claude Code?

Run `npx skills add Dimillian/Skills --skill macos-spm-app-packaging -a claude-code`. Or copy the skill folder (macos-spm-app-packaging in Dimillian/Skills) into .claude/skills/macos-spm-app-packaging in your project. Claude Code loads it when a task matches its description.

How do I install macOS Spm App Packaging in Codex?

Run `npx skills add Dimillian/Skills --skill macos-spm-app-packaging -a codex`. Or copy the skill folder (macos-spm-app-packaging in Dimillian/Skills) into .agents/skills/macos-spm-app-packaging in your project. Codex loads it when a task matches its description.

Can I use macOS Spm App Packaging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Dimillian/Skills --skill macos-spm-app-packaging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macos-spm-app-packaging, .gemini/skills/macos-spm-app-packaging, .github/skills/macos-spm-app-packaging and .opencode/skills/macos-spm-app-packaging in your project.

What does macOS Spm App Packaging need to run?

Going by SKILL.md and its folder, macOS Spm App Packaging needs a shell and Swift for the scripts in its folder and the command-line tools its instructions call (swift and xcrun). Our summary lists: A Bash shell.

Does macOS Spm App Packaging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is macOS Spm App Packaging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does macOS Spm App Packaging use?

macOS Spm App Packaging is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does macOS Spm App Packaging use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 925 tokens, read only when the agent opens those files.

What are the alternatives to macOS Spm App Packaging?

Skills that share tags, products or a category with macOS Spm App Packaging: Build Run Debug (robinebers/openusage, 4.3k stars), Bootstrap iOS (RayFernando1337/rayfernando-skills, 130 stars), macOS Build Run Debug (robinebers/openusage, 4.3k stars) and macOS Swiftpm (robinebers/openusage, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains macOS Spm App Packaging?

Dimillian (a GitHub user) maintains it in Dimillian/Skills, which has 3,987 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on March 29, 2026.

Source: Dimillian/Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.