Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →tldraw/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 13 of 19 test cases with the skill, and 6 of 19 without it.
and 7 more in the full report
10 fixed6 passed either way6 still failing2 broke
Tokens, turns and time describe resource use, not a dollar price.
This benchmark measured an earlier version of the skill.
A newer attempt on gemini-3.6-flash on 10/2/2026 did not produce a publishable comparison (not comparable). The snapshot above is the previously measured run.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
Our legacy server set `_meta["openai/widgetDescription"]` to give dynamic model context. What function should the application client call to update dynamic context?
| Checked | Without skill | With skill |
|---|---|---|
| Updates dynamic model context using app.updateModelContext. | 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, pnpm 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 6 / 19 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.