Improve skills docs

Author: cameroncooke

README.md

@@ -86,6 +86,17 @@ For other clients see: [Smithery XcodeBuildMCP](https://smithery.ai/server/camer
 - Xcode 16.x or later
 - Node.js 18.x or later
 
+## Skill
+
+XcodeBuildMCP now includes an optional agent skill. Some clients (e.g., Cursor, Claude Code) hide MCP tool schemas behind search/progressive disclosure, which can reduce tool discovery and usage. The skill provides a concise overview of available tools to counter that. If your client already exposes tools up front, you likely don’t need it; only use it if your agent isn’t reaching for XcodeBuildMCP tools.
+
+To install, replace `<client-name>` with your client (cursor, claude, codex):
+```bash
+curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --<client-name>
+```
+
+For further information on how to install the skill, see: [docs/SKILLS.md](docs/SKILLS.md)
+
 ## Notes
 
 - XcodeBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.

docs/SKILLS.md

@@ -2,16 +2,22 @@
 
 This repository bundles a minimal skill that summarizes XcodeBuildMCP workflows and tools to help steer clients to use MCP tools, this is espeically important for clients that progressively load or hide MCP tools behind search interfaces (i.e. Cursor, Claude Code).
 
-## Install (Codex CLI)
+## Install (Claude Code)
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --codex
+curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --claude
 ```
 
-## Install (Claude Code)
+## Install (Cursor)
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --claude
+curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --cursor
+```
+
+## Install (Codex CLI)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/cameroncooke/XcodeBuildMCP/main/scripts/install-skill.sh | bash -s -- --codex
 ```
 
 ## Install (Other Clients)
@@ -20,4 +26,8 @@ Some MCP clients do not yet support skills. Use the skill content as a concise,
 
 1. Open `skills/xcodebuildmcp/SKILL.md`.
 2. Copy the body (everything below the YAML frontmatter).
-3. Paste it into the client’s global or project-level instructions/rules area.
+3. Paste it into the client’s global or project-level instructions/rules area.
+
+## Skills
+
+To learn more about skills see: [https://agentskills.io/home](https://agentskills.io/home).

scripts/install-skill.sh

@@ -3,11 +3,11 @@ set -euo pipefail
 
 usage() {
   cat <<'EOF'
-Usage: install-skill.sh --codex|--claude|--dest <path>
+Usage: install-skill.sh --codex|--claude|--cursor|--dest <path>
 
 Installs (or replaces) the XcodeBuildMCP skill.
 
-You must choose a destination with --codex, --claude, or --dest.
+You must choose a destination with --codex, --claude, --cursor, or --dest.
 EOF
 }
 
@@ -23,6 +23,10 @@ while [[ $# -gt 0 ]]; do
       destination="${HOME}/.claude/skills"
       shift
       ;;
+    --cursor)
+      destination="${HOME}/.cursor/skills"
+      shift
+      ;;
     --dest)
       if [[ $# -lt 2 ]]; then
         echo "Missing value for --dest" >&2