Skip to content

Commit a557915

Browse files
YanxRealYanxReal
committed
feat: Skills (5 skills, 52 tools) + Make installer
- skills/xcode-mpc (52, main) + xcode-build (8) + xcode-simulator-vision (20) + xcode-assets (7) + xcode-package (11) — each SKILL.md with frontmatter name/description/allowed-tools - skills/README.md + docs/skills.md (EN) / docs/es/skills.md (ES) — bilingual - scripts/install-skills.sh (bash 3.2 compatible, 5 dests: ~/.agents/skills, ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills, .agents/skills) — --dry-run/--force/--dest/--uninstall/--list - Makefile: install-skills, uninstall-skills, list-skills, skills (alias), skills-help — .PHONY updated - README.md/es: + 📚 skills table row + 🧩 Skills section (make install-skills, 5 skills list, links to skills/README + docs/skills) - .gitignore: ignore .agents/, .claude/, .codex/ local installs - installed via make install-skills to 5 destinations, verified make list-skills
1 parent 7a3cf79 commit a557915

13 files changed

Lines changed: 975 additions & 2 deletions

File tree

‎.gitignore‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,14 @@ Thumbs.db
3131
*.p12
3232
*.mobileprovision
3333

34-
# Editor
34+
# Editor / Agents local installs (skills installed via make install-skills)
3535
.vscode/
3636
.idea/
3737
*.code-workspace
3838
.opencode/
39+
.agents/
40+
.claude/
41+
.codex/
3942

4043
# Logs
4144
npm-debug.log*

‎Makefile‎

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.PHONY: help install deps clean reinstall lint check start dev inspect test fmt doctor enable-corepack
1+
.PHONY: help install deps clean reinstall lint check start dev inspect test fmt doctor enable-corepack skills install-skills uninstall-skills list-skills skills-help
22

33
# Variables
44
YARN ?= yarn
@@ -105,3 +105,21 @@ release: ## Crea tag y push (usa VERSION env, ej: make release VERSION=1.0.1)
105105
git tag v$(VERSION)
106106
git push && git push --tags
107107
@echo "✓ release v$(VERSION) pusheado"
108+
109+
# Skills
110+
skills: install-skills ## Alias de install-skills
111+
112+
install-skills: ## Instala skills (5 skills, 52 tools) a ~/.agents/skills, ~/.claude/skills, etc.
113+
@echo "➜ instalando skills..."
114+
@bash scripts/install-skills.sh $(if $(FORCE),--force,) $(if $(DEST),--dest $(DEST),)
115+
@echo "✓ skills instalados — prueba: make list-skills"
116+
117+
uninstall-skills: ## Desinstala skills de todos los destinos
118+
@bash scripts/install-skills.sh --uninstall
119+
@echo "✓ skills desinstalados"
120+
121+
list-skills: ## Lista skills instalados
122+
@bash scripts/install-skills.sh --list
123+
124+
skills-help: ## Ayuda detallada de skills
125+
@bash scripts/install-skills.sh --help

‎README.es.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -412,6 +412,23 @@ Detalles → [`docs/es/development.md`](docs/es/development.md)
412412
| [`claude-code.md`](docs/es/claude-code.md) | Claude Code | `claude mcp add` / `.mcp.json`, permisos, trust |
413413
| [`development.md`](docs/es/development.md) | Contribuidores | Estructura, cómo añadir tool, CI, release |
414414
| [`architecture.md`](docs/es/architecture.md) | Curiosos | Por qué single-file, helpers, dispatcher, flujo stdio |
415+
| [`skills.md`](docs/es/skills.md) | Todos | 5 skills (52 tools): `xcode-mpc`, `xcode-build`, `xcode-simulator-vision`, `xcode-assets`, `xcode-package` — `make install-skills` |
416+
417+
---
418+
419+
## 🧩 Skills (5 Skills, 52 Herramientas)
420+
421+
Packs modulares que enseñan a tu agente IA cuándo usar cada tool. Instalador fácil vía Make:
422+
423+
```bash
424+
make install # 1. Servidor MCP (Yarn)
425+
make install-skills # 2. Skills → ~/.agents/skills, ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills
426+
make test # 3. Verifica 52 herramientas
427+
make list-skills # lista instalados
428+
make uninstall-skills # desinstala
429+
```
430+
431+
Incluye: `xcode-mpc` (52, principal), `xcode-build` (8), `xcode-simulator-vision` (20), `xcode-assets` (7), `xcode-package` (11). Ver [`skills/README.md`](skills/README.md) y [`docs/es/skills.md`](docs/es/skills.md). Manual: `./scripts/install-skills.sh --dry-run`.
415432

416433
---
417434

‎README.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -412,6 +412,23 @@ Details → [`docs/development.md`](docs/development.md)
412412
| [`claude-code.md`](docs/claude-code.md) | Claude Code | `claude mcp add` / `.mcp.json`, permissions, trust |
413413
| [`development.md`](docs/development.md) | Contributors | Structure, adding a tool, CI, release |
414414
| [`architecture.md`](docs/architecture.md) | Curious | Why single-file, helpers, dispatcher, stdio flow |
415+
| [`skills.md`](docs/skills.md) | Everyone | 5 skills (52 tools): `xcode-mpc`, `xcode-build`, `xcode-simulator-vision`, `xcode-assets`, `xcode-package` — `make install-skills` |
416+
417+
---
418+
419+
## 🧩 Skills (5 Skills, 52 Tools)
420+
421+
Modular packs that teach your AI agent when to use each tool. Easy installer via Make:
422+
423+
```bash
424+
make install # 1. MCP server (Yarn)
425+
make install-skills # 2. Skills → ~/.agents/skills, ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills
426+
make test # 3. Verify 52 tools
427+
make list-skills # list installed
428+
make uninstall-skills # uninstall
429+
```
430+
431+
Includes: `xcode-mpc` (52, main), `xcode-build` (8), `xcode-simulator-vision` (20), `xcode-assets` (7), `xcode-package` (11). See [`skills/README.md`](skills/README.md) and [`docs/skills.md`](docs/skills.md). Manual: `./scripts/install-skills.sh --dry-run`.
415432

416433
---
417434

‎docs/es/skills.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# Skills
2+
3+
> 🌐 **Idioma:** [English](../skills.md) | **Español**
4+
5+
Packs de conocimiento modulares e invocables que enseñan a tu agente IA cuándo y cómo usar las 52 herramientas de Xcode MCP.
6+
7+
## ¿Por Qué Skills?
8+
9+
El servidor MCP tiene **52 herramientas** — demasiadas para explicar en cada prompt. Los skills las agrupan en **5 packs enfocados** (Build, Simulator/Vision, Assets, Package, más el meta-skill **xcode-mpc** de 52). Tu agente carga el skill correcto cuando dices *“compila MyApp”*, *“haz screenshot”*, *“genera AppIcon”*, etc.
10+
11+
## Las 5 Skills
12+
13+
| Skill | Herramientas | Archivo | Disparadores |
14+
|---|---|---|---|
15+
| **`xcode-mpc`** | **52** (todas) | `skills/xcode-mpc/SKILL.md` | **Por defecto** — cualquier iOS/macOS/watchOS/tvOS/visionOS, `xcodebuild`, `simctl`, `Assets`, `SPM`, `Vision`. Empieza aquí. |
16+
| **`xcode-build`** | 8 | `skills/xcode-build/SKILL.md` | `xcode_build`, `xcode_clean`, `xcode_analyze`, `xcode_archive_export`, `swift_format_lint`, `xcode_run_tests`, `xcode_test_coverage` |
17+
| **`xcode-simulator-vision`** | 20 | `skills/xcode-simulator-vision/SKILL.md` | `simctl`, `devicectl`, `xctrace`, `simctl_get_screen_analysis`, `inspect_ui_tree`, `tap_by_text`, `fill_field` |
18+
| **`xcode-assets`** | 7 | `skills/xcode-assets/SKILL.md` | `Assets.xcassets`, `.colorset`, `.imageset`, `AppIcon`, `actool`, `sips` |
19+
| **`xcode-package`** | 11 | `skills/xcode-package/SKILL.md` | `Package.swift`, `Package.resolved`, `Podfile`, `Cartfile`, `SPM`, `CocoaPods`, `compute-checksum` |
20+
21+
Todas en `skills/` en la raíz (inglés-primero).
22+
23+
## Instalación Rápida (Make)
24+
25+
```bash
26+
git clone https://github.com/YanxReal/Xcode-MPC.git
27+
cd Xcode-MPC
28+
make install # 1. Servidor MCP (Yarn)
29+
make install-skills # 2. Skills (5 skills → todos los directorios de agentes)
30+
make test # 3. Verifica 52 herramientas
31+
```
32+
33+
`make install-skills` hace:
34+
35+
- Detecta: `~/.agents/skills` (Opencode), `~/.config/opencode/skills`, `~/.claude/skills` (Claude Code), `~/.codex/skills` (Codex), `.agents/skills` (local)
36+
- Copia `skills/xcode-*` → cada dir con `cp -r`
37+
- Verifica con `make list-skills`, desinstala con `make uninstall-skills`
38+
39+
**Opciones:**
40+
41+
```bash
42+
./scripts/install-skills.sh --dry-run
43+
./scripts/install-skills.sh --dest ~/.claude/skills --force
44+
make install-skills FORCE=1
45+
```
46+
47+
## Instalación Manual (sin Make)
48+
49+
```bash
50+
./scripts/install-skills.sh
51+
./scripts/install-skills.sh --list
52+
./scripts/install-skills.sh --uninstall
53+
```
54+
55+
## Ecosistema Skills.sh (Opcional)
56+
57+
Compatible con `npx skills` (https://skills.sh):
58+
59+
```bash
60+
npx skills find xcode
61+
npx skills add YanxReal/Xcode-MPC --skill xcode-mpc
62+
```
63+
64+
La instalación local vía `make install-skills` es suficiente.
65+
66+
## Usando un Skill
67+
68+
Pide a tu agente:
69+
70+
```
71+
Usa xcode-mpc para compilar MyApp para iPhone 15
72+
Usa xcode-simulator-vision para hacer screenshot y pulsar "Continuar"
73+
Usa xcode-assets para generar AppIcon para todos los OS desde /tmp/1024.png
74+
Usa xcode-package para migrar Podfile a SPM (dryRun primero)
75+
```
76+
77+
El agente carga `SKILL.md` y sabe qué tool MCP + JSON llamar.
78+
79+
## Actualización
80+
81+
```bash
82+
git pull origin main
83+
make install-skills FORCE=1
84+
make test
85+
```
86+
87+
## Ver También
88+
89+
- `README.md` / `README.es.md` — Quick start + Make
90+
- `docs/es/tools.md` — JSON Schema completo 52 tools
91+
- `AGENTS.md` — comportamiento IA, regla bilingüe

‎docs/skills.md‎

Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
# Skills
2+
3+
> 🌐 **Language:** **English** | [Español](es/skills.md)
4+
5+
Modular, user-invocable knowledge packs that teach your AI agent when and how to use the 52 Xcode MCP tools.
6+
7+
## Why Skills?
8+
9+
The MCP server has **52 tools** — too many to explain in every prompt. Skills group them into **5 focused packs** (Build, Simulator/Vision, Assets, Package, plus the full **xcode-mpc** 52-tool meta-skill). Your agent auto-loads the right skill when you mention *“build MyApp”*, *“take a screenshot”*, *“generate AppIcon”*, etc.
10+
11+
## The 5 Skills
12+
13+
| Skill | Tools | File | Triggers |
14+
|---|---|---|---|
15+
| **`xcode-mpc`** | **52** (all) | `skills/xcode-mpc/SKILL.md` | **Default** — any iOS/macOS/watchOS/tvOS/visionOS, `xcodebuild`, `simctl`, `Assets`, `SPM`, `Vision`. Start here. |
16+
| **`xcode-build`** | 8 | `skills/xcode-build/SKILL.md` | `xcode_build`, `xcode_clean`, `xcode_analyze`, `xcode_archive_export`, `swift_format_lint`, `xcode_run_tests`, `xcode_test_coverage` |
17+
| **`xcode-simulator-vision`** | 20 | `skills/xcode-simulator-vision/SKILL.md` | `simctl`, `devicectl`, `xctrace`, `simctl_get_screen_analysis`, `inspect_ui_tree`, `tap_by_text`, `fill_field` |
18+
| **`xcode-assets`** | 7 | `skills/xcode-assets/SKILL.md` | `Assets.xcassets`, `.colorset`, `.imageset`, `AppIcon`, `actool`, `sips` |
19+
| **`xcode-package`** | 11 | `skills/xcode-package/SKILL.md` | `Package.swift`, `Package.resolved`, `Podfile`, `Cartfile`, `SPM`, `CocoaPods`, `compute-checksum` |
20+
21+
All skills are in `skills/` at the repo root (English-first). Each has frontmatter:
22+
23+
```yaml
24+
---
25+
name: xcode-mpc
26+
description: Professional MCP Server for Xcode — 52 tools ...
27+
user-invocable: true
28+
allowed-tools: Bash(xcodebuild *), Bash(xcrun *), ...
29+
---
30+
```
31+
32+
## Quick Install (Make)
33+
34+
```bash
35+
git clone https://github.com/YanxReal/Xcode-MPC.git
36+
cd Xcode-MPC
37+
make install # 1. MCP server (Yarn)
38+
make install-skills # 2. Skills (5 skills → all agent dirs)
39+
make test # 3. Verify 52 tools
40+
```
41+
42+
`make install-skills` does:
43+
44+
- Detects: `~/.agents/skills` (Opencode), `~/.config/opencode/skills`, `~/.claude/skills` (Claude Code), `~/.codex/skills` (Codex), `.agents/skills` (project local)
45+
- Copies `skills/xcode-*` → each dir via `cp -r`
46+
- Use `make list-skills` to verify, `make uninstall-skills` to remove
47+
48+
**Options:**
49+
50+
```bash
51+
./scripts/install-skills.sh --dry-run # preview
52+
./scripts/install-skills.sh --dest ~/.claude/skills --force # custom + overwrite
53+
make install-skills FORCE=1 # overwrite
54+
make install-skills DEST=~/.agents/skills
55+
```
56+
57+
## Manual Install (without Make)
58+
59+
```bash
60+
./scripts/install-skills.sh
61+
./scripts/install-skills.sh --list
62+
./scripts/install-skills.sh --uninstall
63+
```
64+
65+
## Skills.sh Ecosystem (Optional)
66+
67+
Skills are compatible with `npx skills` (https://skills.sh):
68+
69+
```bash
70+
npx skills find xcode
71+
npx skills add YanxReal/Xcode-MPC --skill xcode-mpc # once published
72+
```
73+
74+
Local install via `make install-skills` is enough — `~/.agents/skills/xcode-mpc` is auto-discovered.
75+
76+
## Using a Skill
77+
78+
Just ask your agent (OpenCode, Codex, Claude Code):
79+
80+
```
81+
Use xcode-mpc to build MyApp for iPhone 15
82+
Use xcode-simulator-vision to take a screenshot and tap "Continue"
83+
Use xcode-assets to generate AppIcon for all Apple OS from /tmp/1024.png
84+
Use xcode-package to migrate Podfile to SPM (dryRun first)
85+
```
86+
87+
The agent loads `SKILL.md` and knows which MCP tool + JSON to call.
88+
89+
## Updating
90+
91+
```bash
92+
git pull origin main
93+
make install-skills FORCE=1
94+
make test
95+
```
96+
97+
## Structure
98+
99+
```
100+
skills/
101+
├── README.md
102+
├── xcode-mpc/SKILL.md # 52 tools — main
103+
├── xcode-build/SKILL.md # 8
104+
├── xcode-simulator-vision/SKILL.md # 20
105+
├── xcode-assets/SKILL.md # 7
106+
└── xcode-package/SKILL.md # 11
107+
scripts/install-skills.sh # installer (bash 3.2 compatible)
108+
Makefile: install-skills / list-skills / uninstall-skills / skills-help
109+
```
110+
111+
## See Also
112+
113+
- `README.md` / `README.es.md` — Quick start + Make commands
114+
- `docs/tools.md` — full 52-tool JSON Schema
115+
- `AGENTS.md` — AI behavior, bilingual rule

0 commit comments

Comments
 (0)