Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →awslabs/migrate-oai-app
This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.
Passed 17 of 21 test cases with the skill, and 8 of 21 without it.
and 14 more in the full report
12 fixed7 passed either way2 still failing2 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 12 test cases the skill fixed. Same model, same prompt, with and without the skill.
We want to test our migrated app UI against a reference host runner. Which directory under examples in the cloned repository contains the reference test host?
| Checked | Without skill | With skill |
|---|---|---|
| Identifies basic-host in examples/basic-host as the test runner. | Missed | Passed |
The instructions your model reads when the skill loads.
Migrate existing OpenAI Apps SDK applications to the MCP Apps SDK (@modelcontextprotocol/ext-apps). The MCP Apps SDK provides a standardized, open protocol for interactive UIs in conversational clients.
npm install, pnpm add, yarn add) instead of manually writing version numbers. This lets the package manager resolve the latest compatible versions. Never specify version numbers from memory.Clone the SDK repository for complete migration documentation and working examples:
git clone --branch "v$(npm view @modelcontextprotocol/ext-apps version)" --depth 1 https://github.com/modelcontextprotocol/ext-apps.git /tmp/mcp-ext-apps
Read the migration reference guide with "before/after" mapping tables: /tmp/mcp-ext-apps/docs/migrate_from_openai_apps.md
Read JSDoc documentation directly from /tmp/mcp-ext-apps/src/*:
| File | Contents |
|---|---|
src/app.ts | App class, handlers, lifecycle |
src/server/index.ts | registerAppTool, registerAppResource |
src/spec.types.ts | Type definitions |
src/react/useApp.tsx | useApp hook for React apps |
src/react/use*.ts* | Other use* hooks for React apps |
See /tmp/mcp-ext-apps/examples/basic-server-{framework}/ for basic SDK usage examples organized by front-end framework:
| Template | Key Files |
|---|---|
basic-server-vanillajs/ | server.ts, src/mcp-app.ts, mcp-app.html |
test cases passed, vs 8 / 21 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.