Agent skill

Xcodebuildmcp

by w-winter in w-winter/dot314

Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support).

MITAuto-check passedMobile

Install Xcodebuildmcp

skills CLI
$ npx skills add w-winter/dot314 --skill xcodebuildmcp -a claude-code

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

GitHub CLI
$ gh skill install w-winter/dot314 xcodebuildmcp --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/w-winter/dot314.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xcodebuildmcp .claude/skills/xcodebuildmcp && 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
xcodebuildmcp
GitHub stars
139
Token cost
~196 tokens
SKILL.md length
46 words
Files
5
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support).

  • The user mentions Xcode
  • SKILL.md covers Setup and Usage
  • Runs Shell and TypeScript scripts from its folder; calls npm and npx
  • IOS builds/tests

What it does

Xcodebuildmcp is an agent skill from w-winter/dot314. Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support). Use when the user mentions Xcode, xcodebuild, iOS builds/tests, or XcodeBuildMCP.

Its SKILL.md is about 200 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `package.json`, `xcodebuildmcp.sh` and `xcodebuildmcp.ts`).

It sits in Mobile, covering iOS development and MCP servers. It works with Model Context Protocol, Xcode and iOS. The licence is MIT.

When your agent uses it

  • The user mentions Xcode
  • IOS builds/tests

Example prompts

  • “/xcodebuildmcp”

Requirements

  • Node.js
  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 3e525d4. 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 TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, 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

Xcodebuildmcp loads about 196 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 46 words of instructions outside code blocks.

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

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 w-winter/dot314 at commit 3e525d4, republished under its MIT licence (© w-winter). 46 words, ~196 tokens.

Download SKILL.mdSave it as .claude/skills/xcodebuildmcp/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
xcodebuildmcp
description
Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support). Use when the user mentions Xcode, xcodebuild, iOS builds/tests, or XcodeBuildMCP.
disable-model-invocation
true

xcodebuildmcp

This skill wraps an MCP server behind a local CLI so pi agent can use it without MCP support.

Setup

Run once:

bash
cd {baseDir}
npm install

Usage

Use --output json for agent workflows.

bash
{baseDir}/xcodebuildmcp.sh --help
{baseDir}/xcodebuildmcp.sh --output json <command> [flags]
Regenerating the CLI

If the MCP server adds/removes tools, regenerate the CLI from its embedded metadata:

bash
cd {baseDir}
npx mcporter generate-cli --from ./xcodebuildmcp.ts

© w-winter, 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 4 other files in skills/xcodebuildmcp of w-winter/dot314.

  • SKILL.md
  • LICENSE
  • package.json
  • xcodebuildmcp.sh
  • xcodebuildmcp.ts

Open the folder on GitHubat commit 3e525d4

Compare with similar skills

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

Xcodebuildmcp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xcodebuildmcp this skillw-winter/dot314139—~196Automated safety check: PassMIT
iOS Simulator Workflowsconorluddy/xclaude-plugin183—~3.3kAutomated safety check: PassMIT
Xcode Build Workflowsconorluddy/xclaude-plugin183—~3kAutomated safety check: PassMIT
Update Swiftui APIsAvdLee/SwiftUI-Agent-Skill3.7k—~1.2kAutomated safety check: PassMIT
iOS Simulator Skillconorluddy/ios-simulator-skill1.3k—~5.7kAutomated safety check: PassMIT
Inspector MCPipedro/Inspector170—~3.4kAutomated safety check: PassMIT

Similar skills

  • iOS Simulator Workflows

    conorluddy/xclaude-plugin

    Manages iOS Simulator devices and apps through the execute_simulator_command MCP tool instead of raw simctl: boot, create and delete devices, install and launch apps, screenshots and diagnostics.

    183 GitHub stars~3.3k tokensUpdated 25 days ago
    MobileAuto-check passed
  • Xcode Build Workflows

    conorluddy/xclaude-plugin

    Directs iOS build, test and clean operations through the execute_xcode_command MCP tool instead of raw xcodebuild in the shell, with parameter-level retries on failure.

    183 GitHub stars~3k tokensUpdated 25 days ago
    MobileAuto-check passed
  • Update Swiftui APIs

    AvdLee/SwiftUI-Agent-Skill

    Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

    3.7k GitHub stars~1.2k tokensUpdated yesterday
    MobileAuto-check passed
  • iOS Simulator Skill

    conorluddy/ios-simulator-skill

    29 production-ready scripts for iOS app testing, building, and automation.

    1.3k GitHub stars~5.7k tokensUpdated yesterday
    MobileAuto-check passed
  • Inspector MCP

    ipedro/Inspector

    A skill your agent uses when an agent needs to inspect a live iOS app through the Inspector MCP bridge, register or troubleshoot InspectorMCPServer for a consumer Xcode project, or query, resolve…

    170 GitHub stars~3.4k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Xcode Build

    pzep1/xcode-build-skill

    Build and run iOS/macOS apps using xcodebuild and xcrun simctl directly.

    138 GitHub stars~1.5k tokensUpdated 8 mo ago
    MobileAuto-check: notes

More from w-winter/dot314

  • Refresh RepoPrompt tool guidance when the CLI/MCP surface changes.

    139 GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed
  • Deep X Research

    w-winter/dot314

    Deep, exhaustive research on a topic across X (Twitter) by driving Grok (x.com/i/grok) through surf.

    139 GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed
  • Text Search

    w-winter/dot314

    Search indexed text corpora with qmd. An agent skill from w-winter/dot314.

    139 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • Prose Review

    w-winter/dot314

    Review prose written for others (e.g., user-facing documentation, prompts for other LLMs, reports, plans, inline comments, docstrings) for local jargon leakage, orphaned references, missing…

    139 GitHub stars~3.6k tokensUpdated 4 days ago
    Auto-check passed
  • Rp

    w-winter/dot314

    Always read this skill when the user mentions "rp" or "repoprompt", or before accessing a repository outside the current RepoPrompt workspace.

    139 GitHub stars~3.4k tokensUpdated 4 days ago
    Auto-check passed
  • Surf

    w-winter/dot314

    Control Chrome browser via CLI for testing, automation, and debugging.

    139 GitHub stars~7.6k tokensUpdated 4 days ago
    Auto-check: warnings

Questions about Xcodebuildmcp

What does Xcodebuildmcp do?

Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support). Xcodebuildmcp is an agent skill from w-winter/dot314. Build/test Xcode projects via the XcodeBuildMCP MCP server using a local CLI wrapper for pi (no MCP support).

When should I use Xcodebuildmcp?

Xcodebuildmcp fits situations like: the user mentions Xcode; IOS builds/tests.

How do I install Xcodebuildmcp in Claude Code?

Run `npx skills add w-winter/dot314 --skill xcodebuildmcp -a claude-code`. Or copy the skill folder (skills/xcodebuildmcp in w-winter/dot314) into .claude/skills/xcodebuildmcp in your project. Claude Code loads it when a task matches its description.

How do I install Xcodebuildmcp in Codex?

Run `npx skills add w-winter/dot314 --skill xcodebuildmcp -a codex`. Or copy the skill folder (skills/xcodebuildmcp in w-winter/dot314) into .agents/skills/xcodebuildmcp in your project. Codex loads it when a task matches its description.

Can I use Xcodebuildmcp 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 w-winter/dot314 --skill xcodebuildmcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xcodebuildmcp, .gemini/skills/xcodebuildmcp, .github/skills/xcodebuildmcp and .opencode/skills/xcodebuildmcp in your project.

What does Xcodebuildmcp need to run?

Going by SKILL.md and its folder, Xcodebuildmcp needs a shell and TypeScript for the scripts in its folder and the command-line tools its instructions call (npm and npx). Our summary lists: Node.js; A Bash shell.

Does Xcodebuildmcp access the network?

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

Is Xcodebuildmcp 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 Xcodebuildmcp use?

Xcodebuildmcp is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xcodebuildmcp use?

About 196 tokens (SKILL.md is roughly 784 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 Xcodebuildmcp?

Skills that share tags, products or a category with Xcodebuildmcp: iOS Simulator Workflows (conorluddy/xclaude-plugin, 183 stars), Xcode Build Workflows (conorluddy/xclaude-plugin, 183 stars), Update Swiftui APIs (AvdLee/SwiftUI-Agent-Skill, 3.7k stars) and iOS Simulator Skill (conorluddy/ios-simulator-skill, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xcodebuildmcp?

w-winter (a GitHub user) maintains it in w-winter/dot314, which has 139 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 3, 2026.

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