From 655231ded0c841caeaa36a9e649057f0188cc412 Mon Sep 17 00:00:00 2001
From: Jonathan Hefner <jonathan@hefner.pro>
Date: Sat, 24 Jan 2026 15:08:00 -0600
Subject: [PATCH] Add Agent Skills installation guide

Add `docs/agent-skills.md` with installation instructions for multiple AI
coding agents including Claude Code, VS Code/Copilot, Gemini CLI, Cline,
and Goose. The guide provides three installation methods: Claude Code
plugin, Vercel Skills CLI (`npx skills add`), and manual installation.

Update `README.md` to link to the new guide and reframe the plugin
section around the broader "Agent Skills" concept.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md                  |  6 +++--
 docs/agent-skills.md       | 53 ++++++++++++++++++++++++++++++++++++++
 plugins/mcp-apps/README.md |  2 +-
 typedoc.config.mjs         |  1 +
 4 files changed, 59 insertions(+), 3 deletions(-)
 create mode 100644 docs/agent-skills.md

diff --git a/README.md b/README.md
index 85642559..84e08005 100644
--- a/README.md
+++ b/README.md
@@ -44,15 +44,17 @@ We have [contributed a tentative implementation](https://github.com/MCP-UI-Org/m
 npm install -S @modelcontextprotocol/ext-apps
 ```
 
-### Claude Code Plugin
+### Install Agent Skills
 
-A [Claude Code plugin](https://github.com/modelcontextprotocol/ext-apps/tree/main/plugins/mcp-apps) is available to help create MCP Apps. To install, run these commands inside Claude Code:
+This repository provides two [Agent Skills](https://agentskills.io/) for building MCP Apps. You can install the skills as a Claude Code plugin:
 
 ```
 /plugin marketplace add modelcontextprotocol/ext-apps
 /plugin install mcp-apps@modelcontextprotocol-ext-apps
 ```
 
+Or you can install the skills in your favorite AI coding agent by following the [skills installation guide](./docs/agent-skills.md).
+
 ## Examples
 
 <!-- prettier-ignore-start -->
diff --git a/docs/agent-skills.md b/docs/agent-skills.md
new file mode 100644
index 00000000..82a884ae
--- /dev/null
+++ b/docs/agent-skills.md
@@ -0,0 +1,53 @@
+---
+title: Agent Skills
+---
+
+# Install the Skills
+
+The MCP Apps repository provides two [Agent Skills](https://agentskills.io/) for AI coding agents: one for scaffolding MCP Apps with interactive UIs, and one for migrating from the OpenAI Apps SDK.
+
+Choose one of the following installation methods based on your agent:
+
+## Option 1: Claude Code Plugin
+
+Install via Claude Code:
+
+```
+/plugin marketplace add modelcontextprotocol/ext-apps
+/plugin install mcp-apps@modelcontextprotocol-ext-apps
+```
+
+## Option 2: Vercel Skills CLI
+
+Use the [Vercel Skills CLI](https://skills.sh/) to install skills across different AI coding agents:
+
+```bash
+npx skills add modelcontextprotocol/ext-apps
+```
+
+## Option 3: Manual Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/modelcontextprotocol/ext-apps.git
+```
+
+Then copy the skills from `plugins/mcp-apps/skills/` to your agent's skills directory. See your agent's documentation for the correct location:
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code/skills)
+- [VS Code](https://code.visualstudio.com/docs/copilot/customization/agent-skills) / [GitHub Copilot](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
+- [Gemini CLI](https://geminicli.com/docs/cli/skills/)
+- [Cline](https://docs.cline.bot/features/skills#skills)
+- [Goose](https://block.github.io/goose/docs/guides/context-engineering/using-skills/)
+
+## Verify Installation
+
+Ask your agent "What skills do you have?" — you should see `create-mcp-app` and `migrate-oai-app` among the available skills.
+
+## Next Steps
+
+Try invoking the skills by asking your agent:
+
+- "Create an MCP App" — scaffolds a new MCP App with an interactive UI
+- "Migrate from OpenAI Apps SDK" — converts an existing OpenAI App to use the MCP Apps SDK
diff --git a/plugins/mcp-apps/README.md b/plugins/mcp-apps/README.md
index 8a326daf..541495c7 100644
--- a/plugins/mcp-apps/README.md
+++ b/plugins/mcp-apps/README.md
@@ -1,6 +1,6 @@
 # MCP Apps Plugin for Claude Code
 
-A Claude Code plugin that provides the "Create MCP App" skill for building MCP Apps with interactive UIs.
+A Claude Code plugin that provides skills for building MCP Apps.
 
 ## Installation
 
diff --git a/typedoc.config.mjs b/typedoc.config.mjs
index 0d029678..b6a76353 100644
--- a/typedoc.config.mjs
+++ b/typedoc.config.mjs
@@ -10,6 +10,7 @@ const config = {
   projectDocuments: [
     "docs/overview.md",
     "docs/quickstart.md",
+    "docs/agent-skills.md",
     "docs/patterns.md",
     "docs/migrate_from_openai_apps.md",
   ],