Date: Fri, 20 Feb 2026 19:37:58 +0000
Subject: [PATCH 1/7] Lead README with agent skills for faster onboarding
Move the agent skills section to the top of the README so readers
immediately see how to install and start building. Keep Claude Code
install commands front and center with a brief pointer to the agent
skills guide for other agents. Specification section moves below
Examples.
---
README.md | 49 ++++++++++++++++++++++++++++---------------------
1 file changed, 28 insertions(+), 21 deletions(-)
diff --git a/README.md b/README.md
index de0c4ade..66ae56be 100644
--- a/README.md
+++ b/README.md
@@ -34,28 +34,35 @@
## Table of Contents
-- [Specification](#specification)
+- [Build with Agent Skills](#build-with-agent-skills)
- [Why MCP Apps?](#why-mcp-apps)
- [How It Works](#how-it-works)
- [Getting Started](#getting-started)
- [Using the SDK](#using-the-sdk)
-- [Agent Skills](#agent-skills)
- [Examples](#examples)
+- [Specification](#specification)
- [Resources](#resources)
- [Contributing](#contributing)
-## Specification
+## Build with Agent Skills
-
+The fastest way to build an MCP App is to let your AI coding agent do it. This repo ships two [Agent Skills](https://agentskills.io/) — install them once, then just ask:
-| Version | Status | Link |
-| -------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
-| **2026-01-26** | Stable | [specification/2026-01-26/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx) |
-| **draft** | Development | [specification/draft/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx) |
+- **"Create an MCP App"** — scaffolds a new MCP App with an interactive UI from scratch
+- **"Migrate from OpenAI Apps SDK"** — converts an existing OpenAI App to use MCP Apps
-
+### Install the Skills
-MCP Apps are a proposed standard inspired by [MCP-UI](https://mcpui.dev/) and [OpenAI's Apps SDK](https://developers.openai.com/apps-sdk/) to allow MCP Servers to display interactive UI elements in conversational MCP clients / chatbots.
+**Claude Code** — install via the plugin marketplace:
+
+```
+/plugin marketplace add modelcontextprotocol/ext-apps
+/plugin install mcp-apps@modelcontextprotocol-ext-apps
+```
+
+**Other agents** — any AI coding agent that supports [Agent Skills](https://agentskills.io/) can use these skills. See the [agent skills guide](./docs/agent-skills.md) for manual installation instructions.
+
+Once installed, verify by asking your agent _"What skills do you have?"_ — you should see `create-mcp-app` and `migrate-oai-app` in the list. Then just ask it to create or migrate an app and it will guide you through the rest.
## Why MCP Apps?
@@ -95,17 +102,6 @@ There's no _supported_ host implementation in this repo (beyond the [examples/ba
The [MCP-UI](https://github.com/idosal/mcp-ui) client SDK offers a fully-featured MCP Apps framework used by a few hosts. Clients may choose to use it or roll their own implementation.
-## Agent Skills
-
-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
-```
-
-For more information, including instructions for installing the skills in your favorite AI coding agent, see the [agent skills guide](./docs/agent-skills.md).
-
## Examples
The [`examples/`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples) directory contains demo apps showcasing real-world use cases.
@@ -546,6 +542,17 @@ Then configure your MCP client to build and run the local server. Replace `~/cod
This configuration rebuilds each server on launch, ensuring your local changes are picked up.
+## Specification
+
+
+
+| Version | Status | Link |
+| -------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| **2026-01-26** | Stable | [specification/2026-01-26/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx) |
+| **draft** | Development | [specification/draft/apps.mdx](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx) |
+
+
+
## Resources
- [Quickstart Guide](https://modelcontextprotocol.github.io/ext-apps/api/documents/Quickstart.html)
From 2af02baf46c29a2eef7813097e46868f8bb233c9 Mon Sep 17 00:00:00 2001
From: Den Delimarsky
Date: Fri, 20 Feb 2026 20:47:02 +0000
Subject: [PATCH 2/7] Update README hero gif to Excalidraw, add new agent
skills
---
README.md | 398 +--------------
docs/agent-skills.md | 8 +-
media/excalidraw.gif | Bin 0 -> 10343437 bytes
.../skills/add-app-to-server/SKILL.md | 389 +++++++++++++++
.../mcp-apps/skills/convert-web-app/SKILL.md | 469 ++++++++++++++++++
5 files changed, 881 insertions(+), 383 deletions(-)
create mode 100644 media/excalidraw.gif
create mode 100644 plugins/mcp-apps/skills/add-app-to-server/SKILL.md
create mode 100644 plugins/mcp-apps/skills/convert-web-app/SKILL.md
diff --git a/README.md b/README.md
index 66ae56be..3558ec9d 100644
--- a/README.md
+++ b/README.md
@@ -28,8 +28,8 @@