From d1b713c9ac706c96ce193c2bc9ded926857b03e5 Mon Sep 17 00:00:00 2001
From: Antoine van der Lee <4329185+AvdLee@users.noreply.github.com>
Date: Fri, 7 Aug 2026 15:17:46 +0200
Subject: [PATCH] Adopt Agent Plugins 1.0.0 portable format

Add a root plugin.json manifest per the Agent Plugins specification
(https://agent-plugins.org); the skills/ layout already conformed, so
no skill moves were needed. Compatible clients now discover all six
skills automatically.

Aligns all wrapper versions at 1.1.0 (Cursor and Codex manifests had
drifted to 1.0.0), adds per-skill ChatGPT desktop display metadata, and
updates the release workflow to bump every manifest.
---
 .claude-plugin/marketplace.json               |  4 +--
 .claude-plugin/plugin.json                    |  2 +-
 .cursor-plugin/plugin.json                    |  5 ++--
 .github/workflows/release.yml                 |  8 +++++-
 README.md                                     |  8 +++---
 agents/openai.yaml                            |  2 +-
 plugin.json                                   | 28 +++++++++++++++++++
 skills/spm-build-analysis/agents/openai.yaml  |  4 +++
 .../xcode-build-benchmark/agents/openai.yaml  |  4 +++
 skills/xcode-build-fixer/agents/openai.yaml   |  4 +++
 .../agents/openai.yaml                        |  4 +++
 .../agents/openai.yaml                        |  4 +++
 .../xcode-project-analyzer/agents/openai.yaml |  4 +++
 13 files changed, 70 insertions(+), 11 deletions(-)
 create mode 100644 plugin.json
 create mode 100644 skills/spm-build-analysis/agents/openai.yaml
 create mode 100644 skills/xcode-build-benchmark/agents/openai.yaml
 create mode 100644 skills/xcode-build-fixer/agents/openai.yaml
 create mode 100644 skills/xcode-build-orchestrator/agents/openai.yaml
 create mode 100644 skills/xcode-compilation-analyzer/agents/openai.yaml
 create mode 100644 skills/xcode-project-analyzer/agents/openai.yaml

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 2414488..2451cbc 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/marketplace/marketplace.schema.json",
   "name": "xcode-build-skills",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "owner": {
     "name": "Antoine van der Lee",
     "email": "contact@avanderlee.com"
@@ -14,7 +14,7 @@
       "name": "xcode-build-skills",
       "description": "Six Xcode build optimization skills in one plugin: benchmark, compilation analysis, project analysis, SPM build analysis, a recommend-first orchestrator, and a fixer for applying approved changes.",
       "repository": "https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill",
-      "version": "1.0.1",
+      "version": "1.1.0",
       "author": {
         "name": "Antoine van der Lee",
         "email": "contact@avanderlee.com"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 8c6c1ee..e4b5828 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "xcode-build-skills",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A multi-skill plugin for benchmarking and optimizing Xcode builds, compile hotspots, project settings, and Swift Package Manager dependency overhead.",
   "author": {
     "name": "Antoine van der Lee",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index c585193..c1e2aa5 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "xcode-build-skills",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A multi-skill plugin for benchmarking and optimizing Xcode builds, compile hotspots, project settings, and Swift Package Manager dependency overhead.",
   "author": {
     "name": "Antoine van der Lee",
@@ -30,5 +30,6 @@
     "skills/spm-build-analysis",
     "skills/xcode-build-orchestrator",
     "skills/xcode-build-fixer"
-  ]
+  ],
+  "homepage": "https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill"
 }
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 80e66b3..c70bf56 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -60,6 +60,12 @@ jobs:
       - name: Bump plugin manifest version
         run: |
           set -euo pipefail
+          for manifest in plugin.json .cursor-plugin/plugin.json; do
+            jq --arg version "$VERSION" '.version = $version' "$manifest" > "$manifest.tmp"
+            mv "$manifest.tmp" "$manifest"
+          done
+          sed -i -E "s/^version: \".*\"$/version: \"$VERSION\"/" agents/openai.yaml
+
           jq --arg version "$VERSION" '.version = $version' .claude-plugin/plugin.json > .claude-plugin/plugin.json.tmp
           mv .claude-plugin/plugin.json.tmp .claude-plugin/plugin.json
 
@@ -78,7 +84,7 @@ jobs:
           fi
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add .claude-plugin/plugin.json .claude-plugin/marketplace.json
+          git add plugin.json .cursor-plugin/plugin.json agents/openai.yaml .claude-plugin/plugin.json .claude-plugin/marketplace.json
           git commit -m "Bump version to $VERSION"
           git push
 
diff --git a/README.md b/README.md
index 20b12c7..df0ed1c 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@
 
 Open-source Agent Skills for benchmarking and optimizing Xcode build performance across clean builds, incremental builds, compile hotspots, project settings, and Swift Package Manager overhead.
 
+This repository is packaged as a portable [Agent Plugin](https://agent-plugins.org) (spec 1.0.0): compatible clients discover all six skills automatically from the root `plugin.json` manifest and the `skills/` directory. Client-specific manifests for Claude Code, Cursor, Codex, and pi are included as well.
+
 ## Quick Start
 
 Install all six skills (the orchestrator needs the specialist skills to work):
@@ -162,11 +164,9 @@ To enable for everyone in a repository, add to your project configuration:
 }
 ```
 
-### Option C: Cursor Plugin (coming soon)
-
-This repository is packaged for Cursor plugin submission, but the marketplace listing is not live yet.
+### Option C: Cursor Plugin
 
-Once approved, you'll be able to install it from the Cursor Marketplace.
+Load the plugin from a local clone by placing it in `~/.cursor/plugins/local`, or install it from the Cursor Marketplace once listed. Cursor supports both the portable Agent Plugins manifest (`plugin.json`) and the Cursor Plugin manifest (`.cursor-plugin/plugin.json`) included in this repository.
 
 ### Option D: Codex / OpenAI-compatible tools
 
diff --git a/agents/openai.yaml b/agents/openai.yaml
index c9d206e..22ea483 100644
--- a/agents/openai.yaml
+++ b/agents/openai.yaml
@@ -1,5 +1,5 @@
 name: xcode-build-skills
-version: "1.0.0"
+version: "1.1.0"
 description: >-
   A multi-skill plugin for benchmarking and optimizing Xcode builds,
   compile hotspots, project settings, and Swift Package Manager
diff --git a/plugin.json b/plugin.json
new file mode 100644
index 0000000..3cc0e57
--- /dev/null
+++ b/plugin.json
@@ -0,0 +1,28 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "xcode-build-skills",
+  "version": "1.1.0",
+  "description": "A multi-skill plugin for benchmarking and optimizing Xcode builds, compile hotspots, project settings, and Swift Package Manager dependency overhead.",
+  "author": {
+    "name": "Antoine van der Lee",
+    "email": "contact@avanderlee.com",
+    "url": "https://www.avanderlee.com"
+  },
+  "homepage": "https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill",
+  "repository": "https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill",
+  "license": "MIT",
+  "keywords": [
+    "xcode",
+    "builds",
+    "incremental-builds",
+    "clean-builds",
+    "swift",
+    "ios",
+    "macos",
+    "spm",
+    "benchmarking",
+    "compilation",
+    "project-settings",
+    "explicit-modules"
+  ]
+}
diff --git a/skills/spm-build-analysis/agents/openai.yaml b/skills/spm-build-analysis/agents/openai.yaml
new file mode 100644
index 0000000..83409c3
--- /dev/null
+++ b/skills/spm-build-analysis/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "SPM Build Analysis"
+  short_description: "Analyze Swift Package Manager dependencies and plugin overhead that slow builds."
+  brand_color: "#0071E3"
diff --git a/skills/xcode-build-benchmark/agents/openai.yaml b/skills/xcode-build-benchmark/agents/openai.yaml
new file mode 100644
index 0000000..89739ba
--- /dev/null
+++ b/skills/xcode-build-benchmark/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Xcode Build Benchmark"
+  short_description: "Repeatable clean and incremental build baselines with timing summaries."
+  brand_color: "#0071E3"
diff --git a/skills/xcode-build-fixer/agents/openai.yaml b/skills/xcode-build-fixer/agents/openai.yaml
new file mode 100644
index 0000000..9dd192f
--- /dev/null
+++ b/skills/xcode-build-fixer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Xcode Build Fixer"
+  short_description: "Apply approved build optimizations and re-benchmark to verify improvement."
+  brand_color: "#0071E3"
diff --git a/skills/xcode-build-orchestrator/agents/openai.yaml b/skills/xcode-build-orchestrator/agents/openai.yaml
new file mode 100644
index 0000000..16dcba0
--- /dev/null
+++ b/skills/xcode-build-orchestrator/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Xcode Build Orchestrator"
+  short_description: "Coordinate benchmarking, analysis, and prioritized build optimizations."
+  brand_color: "#0071E3"
diff --git a/skills/xcode-compilation-analyzer/agents/openai.yaml b/skills/xcode-compilation-analyzer/agents/openai.yaml
new file mode 100644
index 0000000..38d5241
--- /dev/null
+++ b/skills/xcode-compilation-analyzer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Xcode Compilation Analyzer"
+  short_description: "Find Swift and mixed-language compile hotspots from build timing data."
+  brand_color: "#0071E3"
diff --git a/skills/xcode-project-analyzer/agents/openai.yaml b/skills/xcode-project-analyzer/agents/openai.yaml
new file mode 100644
index 0000000..090a3f1
--- /dev/null
+++ b/skills/xcode-project-analyzer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Xcode Project Analyzer"
+  short_description: "Audit project configuration, build settings, and script phases for build-time wins."
+  brand_color: "#0071E3"