Agent skill

Test macOS App

by robinebers in robinebers/openusage

Slash command that runs the smallest meaningful macOS test scope first and explains failures by category.

MITAuto-check passedAgent Workflows

Install Test macOS App

skills CLI
$ npx skills add robinebers/openusage --skill test-macos-app -a claude-code

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

GitHub CLI
$ gh skill install robinebers/openusage test-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/test-macos-app .claude/skills/test-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
test-macos-app
GitHub stars
4.3k
Token cost
~273 tokens
SKILL.md length
119 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Slash command that runs the smallest meaningful macOS test scope first and explains failures by category.

  • Works in 4 steps: Detect whether the repo uses xcodebuild… → Prefer focused test execution when a… → Classify failures as compile, assertion,… → …
  • Tasks that involve Hooks and plugins
  • SKILL.md covers Arguments, Workflow and Guardrails
  • Calls xcodebuild and swift

What it does

Test macOS App is an agent skill from robinebers/openusage. Slash command that runs the smallest meaningful macOS test scope first and explains failures by category. Invoke explicitly with /test-macos-app — this skill never self-triggers.

Its SKILL.md is about 270 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. 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

  • “/test-macos-app”

Workflow steps

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

  1. Detect whether the repo uses xcodebuild test or swift test.
  2. Prefer focused test execution when a target or filter is provided.
  3. Classify failures as compile, assertion, crash, env/setup, or flake.
  4. Summarize the top blocker and the narrowest sensible next step.

What it can do on your machine

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

    • xcodebuild
    • swift

    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

Test macOS App loads about 273 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 119 words of instructions outside code blocks.

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

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 cb21465, republished under its MIT licence (© robinebers). 119 words, ~273 tokens.

Download SKILL.mdSave it as .claude/skills/test-macos-app/SKILL.md (or your agent's skills folder).
name
test-macos-app
description
Slash command that runs the smallest meaningful macOS test scope first and explains failures by category. Invoke explicitly with /test-macos-app — this skill never self-triggers.
disable-model-invocation
true

Test macOS App

Run the smallest meaningful macOS test scope first and explain failures by category.

Arguments

  • scheme: Xcode scheme name (optional)
  • target: test target or product name (optional)
  • filter: test filter expression (optional)
  • configuration: Debug or Release (optional, default: Debug)

Workflow

  1. Detect whether the repo uses xcodebuild test or swift test.
  2. Prefer focused test execution when a target or filter is provided.
  3. Classify failures as compile, assertion, crash, env/setup, or flake.
  4. Summarize the top blocker and the narrowest sensible next step.

Guardrails

  • Avoid rerunning the full suite if a focused rerun is possible.
  • Distinguish build failures from actual failing tests.
  • Note when host app setup or simulator-only test assumptions leak into a macOS run.

© 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/test-macos-app of robinebers/openusage.

Open the folder on GitHubat commit cb21465

Compare with similar skills

Test 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.

Test macOS App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test macOS App this skillrobinebers/openusage4.3k—~273Automated safety check: PassMIT
OpenGUI Installer for DSHCore-Mate/OpenGUI1.8k—~1.1kAutomated safety check: PassCustom licence
OpenGUI Plugin InstallerCore-Mate/OpenGUI1.8k—~1kAutomated safety check: PassCustom licence
cmux Diagnosticsmanaflow-ai/cmux28k1 repos~819Automated safety check: PassCustom licence
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • OpenGUI Installer for DSH

    Core-Mate/OpenGUI

    Installs and verifies the latest stable OpenGUI release in a DeepSeek Harness web profile on macOS without disturbing existing plugins or settings.

    1.8k GitHub stars~1.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • OpenGUI Plugin Installer

    Core-Mate/OpenGUI

    Installs or upgrades the standalone OpenGUI plugin for Codex or WorkBuddy on macOS from verified prebuilt GitHub releases, checking the SHA-256 before running anything.

    1.8k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • cmux Diagnostics

    manaflow-ai/cmux

    Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.

    28k GitHub starsUsed in 1 repo~819 tokens
    Productivity & AutomationAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    Auto-check passed

Works with

Categories

Questions about Test macOS App

What does Test macOS App do?

Slash command that runs the smallest meaningful macOS test scope first and explains failures by category. Test macOS App is an agent skill from robinebers/openusage. Slash command that runs the smallest meaningful macOS test scope first and explains failures by category.

When should I use Test macOS App?

Test macOS App fits situations like: tasks that involve Hooks and plugins.

How do I install Test macOS App in Claude Code?

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

How do I install Test macOS App in Codex?

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

Can I use Test 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 test-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/test-macos-app, .gemini/skills/test-macos-app, .github/skills/test-macos-app and .opencode/skills/test-macos-app in your project.

What does Test macOS App need to run?

Going by SKILL.md and its folder, Test macOS App needs the command-line tools its instructions call (xcodebuild and swift).

Does Test macOS App 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 Test 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 Test macOS App use?

Test 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 Test macOS App use?

About 273 tokens (SKILL.md is roughly 1.1k 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 Test macOS App?

Skills that share tags, products or a category with Test macOS App: OpenGUI Installer for DSH (Core-Mate/OpenGUI, 1.8k stars), OpenGUI Plugin Installer (Core-Mate/OpenGUI, 1.8k stars), cmux Diagnostics (manaflow-ai/cmux, 28k stars) and Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test macOS App?

robinebers (a GitHub user) maintains it in robinebers/openusage, which has 4,335 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 6, 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.