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

Build And Run macOS App

by robinebers in robinebers/openusage

Slash command that creates or updates the project-local macOS script/buildandrun.sh and uses it as the default build/run entrypoint.

MITAuto-check passedAgent Workflows

Install Build And Run macOS App

skills CLI
$ npx skills add robinebers/openusage --skill build-and-run-macos-app -a claude-code

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

GitHub CLI
$ gh skill install robinebers/openusage build-and-run-macos-app --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/robinebers/openusage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/build-and-run-macos-app .claude/skills/build-and-run-macos-app && 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
build-and-run-macos-app
GitHub stars
4.3k
Token cost
~473 tokens
SKILL.md length
222 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Slash command that creates or updates the project-local macOS script/buildandrun.sh and uses it as the default build/run entrypoint.

  • Works in 7 steps: Detect whether the repo uses an Xcode… → If the workspace is not inside git yet,… → Create or update script/build_and_run.sh… → …
  • Tasks that involve Hooks and plugins
  • SKILL.md covers Arguments, Workflow and Guardrails
  • Calls git

What it does

Build And Run macOS App is an agent skill from robinebers/openusage. Slash command that creates or updates the project-local macOS script/buildandrun.sh and uses it as the default build/run entrypoint. Invoke explicitly with /build-and-run-macos-app — this skill never self-triggers.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Hooks and plugins. It works with macOS, Git, Xcode and Swift. The repository describes itself as: Burning through your subscriptions too fast? Paying for stuff you never use? Stop guessing. OpenUsage is free and open source. The licence is MIT.

When your agent uses it

  • Tasks that involve Hooks and plugins

Example prompts

  • “/build-and-run-macos-app”

Workflow steps

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

  1. Detect whether the repo uses an Xcode workspace, Xcode project, or SwiftPM package.
  2. If the workspace is not inside git yet, run git init at the project root so git-backed editor features unlock.
  3. Create or update script/build_and_run.sh so it always stops the current app, builds the macOS target, and launches the fresh result.
  4. For SwiftPM, keep raw executable launch only for true CLI tools; for AppKit/SwiftUI GUI apps, create a project-local .app bundle and…
  5. Support optional script flags for --debug, --logs, --telemetry, and --verify.
  6. Follow the canonical bootstrap contract in ../build-run-debug/references/build-script.md for the exact script shape.
  7. Run the script in the requested mode and summarize any build, script, or launch failure.

What it can do on your machine

Read from SKILL.md and the folder at commit bb7de17. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Build And Run macOS App loads about 473 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 222 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~473

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 robinebers/openusage at commit bb7de17, republished under its MIT licence (© robinebers). 222 words, ~473 tokens.

Download SKILL.mdSave it as .claude/skills/build-and-run-macos-app/SKILL.md (or your agent's skills folder).
name
build-and-run-macos-app
description
Slash command that creates or updates the project-local macOS `script/build_and_run.sh` and uses it as the default build/run entrypoint. Invoke explicitly with /build-and-run-macos-app — this skill never self-triggers.
disable-model-invocation
true

Build And Run macOS App

Create or update the project-local macOS build_and_run.sh script, then use that script as the default build/run entrypoint.

Arguments

  • scheme: Xcode scheme name (optional)
  • workspace: path to .xcworkspace (optional)
  • project: path to .xcodeproj (optional)
  • product: SwiftPM executable product name (optional)
  • mode: run, debug, logs, telemetry, or verify (optional, default: run)
  • app_name: process/app name to stop before relaunching (optional)

Workflow

  1. Detect whether the repo uses an Xcode workspace, Xcode project, or SwiftPM package.
  2. If the workspace is not inside git yet, run git init at the project root so git-backed editor features unlock.
  3. Create or update script/build_and_run.sh so it always stops the current app, builds the macOS target, and launches the fresh result.
  4. For SwiftPM, keep raw executable launch only for true CLI tools; for AppKit/SwiftUI GUI apps, create a project-local .app bundle and launch it with /usr/bin/open -n.
  5. Support optional script flags for --debug, --logs, --telemetry, and --verify.
  6. Follow the canonical bootstrap contract in ../build-run-debug/references/build-script.md for the exact script shape.
  7. Run the script in the requested mode and summarize any build, script, or launch failure.

Guardrails

  • Do not initialize a nested git repo inside an existing parent checkout.
  • Keep the no-flag script path simple: kill, build, run.
  • Use --debug, --logs, --telemetry, or --verify only when the user asks for those modes.

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

Files

Just SKILL.md in .agents/skills/build-and-run-macos-app of robinebers/openusage.

Open the folder on GitHubat commit bb7de17

Compare with similar skills

Build And Run macOS App 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.

Build And Run macOS App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Build And Run macOS App this skillrobinebers/openusage4.3k—~473Automated safety check: PassMIT
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
macOS Releasefayazara/macos-app-skills676—~1.8kAutomated safety check: PassNone
Build Afmscouzi1966/maclocal-api346—~1.8kAutomated safety check: NotesMIT
Bootstrap iOSRayFernando1337/rayfernando-skills130—~1.1kAutomated safety check: PassApache-2.0
Swift Developmentaiskillstore/marketplace433—~1.8kAutomated safety check: PassNone

Similar skills

  • macOS Spm App Packaging

    Dimillian/Skills

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

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

  • macOS Release

    fayazara/macos-app-skills

    Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates.

    676 GitHub stars~1.8k tokensUpdated 4 mo ago
    MobileAuto-check passed

  • Build Afm

    scouzi1966/maclocal-api

    Build AFM from scratch — submodules, patches, webui, and Swift build.

    346 GitHub stars~1.8k tokensUpdated yesterday
    MobileAuto-check: notes

  • 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

  • Swift Development

    aiskillstore/marketplace

    Comprehensive Swift development for building, testing, and deploying iOS/macOS applications.

    433 GitHub stars~1.8k tokensUpdated yesterday
    MobileAuto-check passed

  • Compound Engineering Setup

    EveryInc/compound-engineering-plugin

    Checks Compound Engineering plugin health and repo-local config, or scaffolds a Compound Pack when you ask for one by id.

    25k GitHub stars~2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from robinebers/openusage

All 25 skills in this repo

  • Swiftui Patterns

    robinebers/openusage

    Best practices and example-driven guidance for building native macOS SwiftUI scenes and components, including windows, commands, toolbars, settings, split views, inspectors, menu bar extras, and…

    4.3k GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed

  • macOS Telemetry

    robinebers/openusage

    Add and verify lightweight macOS runtime telemetry. An agent skill from robinebers/openusage.

    4.3k GitHub stars~934 tokensUpdated yesterday
    Auto-check passed

  • Release Swift

    robinebers/openusage

    Cut a release of OpenUsage (Swift menu-bar app): pick a version, generate a categorized changelog, tag from main, and publish the GitHub Release with notes.

    4.3k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed

  • Telemetry

    robinebers/openusage

    Add lightweight runtime telemetry and debug instrumentation to macOS apps, then verify those events after building and running.

    4.3k GitHub stars~977 tokensUpdated yesterday
    Auto-check passed

  • Window Management

    robinebers/openusage

    Customize macOS 15+ SwiftUI windows and scene behavior using Window, WindowGroup, and macOS window modifiers.

    4.3k GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

  • Appkit Interop

    robinebers/openusage

    Decide when and how to bridge a macOS app from SwiftUI into AppKit.

    4.3k GitHub stars~741 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Build And Run macOS App

What does Build And Run macOS App do?

Slash command that creates or updates the project-local macOS script/buildandrun.sh and uses it as the default build/run entrypoint. Build And Run macOS App is an agent skill from robinebers/openusage.sh and uses it as the default build/run entrypoint.

When should I use Build And Run macOS App?

Build And Run macOS App fits situations like: tasks that involve Hooks and plugins.

How do I install Build And Run macOS App in Claude Code?

Run `npx skills add robinebers/openusage --skill build-and-run-macos-app -a claude-code`. Or copy the skill folder (.agents/skills/build-and-run-macos-app in robinebers/openusage) into .claude/skills/build-and-run-macos-app in your project. Claude Code loads it when a task matches its description.

How do I install Build And Run macOS App in Codex?

Run `npx skills add robinebers/openusage --skill build-and-run-macos-app -a codex`. Or copy the skill folder (.agents/skills/build-and-run-macos-app in robinebers/openusage) into .agents/skills/build-and-run-macos-app in your project. Codex loads it when a task matches its description.

Can I use Build And Run macOS App 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 robinebers/openusage --skill build-and-run-macos-app -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-and-run-macos-app, .gemini/skills/build-and-run-macos-app, .github/skills/build-and-run-macos-app and .opencode/skills/build-and-run-macos-app in your project.

What does Build And Run macOS App need to run?

Going by SKILL.md and its folder, Build And Run macOS App needs the command-line tools its instructions call (git).

Does Build And Run macOS App access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Build And Run macOS App 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 Build And Run macOS App use?

Build And Run macOS App 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 Build And Run macOS App use?

About 473 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Build And Run macOS App?

Skills that share tags, products or a category with Build And Run macOS App: macOS Spm App Packaging (Dimillian/Skills, 4k stars), macOS Release (fayazara/macos-app-skills, 676 stars), Build Afm (scouzi1966/maclocal-api, 346 stars) and Bootstrap iOS (RayFernando1337/rayfernando-skills, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Build And Run macOS App?

robinebers (a GitHub user) maintains it in robinebers/openusage, which has 4,341 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 10, 2026.

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