OverviewInstructionBenchmarkShowcase
Original OpenAI Skill · independently packaged
Build ChatGPT App guides a coding assistant through the Apps SDK in a set order: read the current docs first, choose one app shape, plan the tools before writing code, then scaffold an MCP server and widget UI. At the end it reports exactly which validation actually ran.
How a request becomes an app
A ChatGPT app is more than a server or a widget on its own. The value is in the connections: a tool the model can choose correctly, a UI resource the host can render, and a bridge that carries results between them.
Create a tiny Node and vanilla-widget app named Release Compass, with a show_release tool. Keep the first iteration local.
vanilla-widgetA small starter where a single HTML widget is enough. The Skill picks one primary archetype and says which one, so you can correct it early.show_releaseA “Use this when…” description, an explicit input schema, and honest annotations: read-only, non-destructive, closed-world, idempotent.ui://widget/main-v1.htmlRegistered with the MCP Apps UI MIME type, a declared CSP and a border preference. It is linked from the tool through _meta.ui.resourceUri.This diagram is based on the real Release Compass starter produced by the Skill’s bundled script. The Showcase page holds the actual run record.
The exchange
window.openai as an optional extensionFive supported shapes
The Skill infers a single primary archetype before choosing examples or scaffolds. It moves to the heavier shapes only when the request calls for them.
search and fetch tools.public/ assets.server/ + web/ layout, starting from official OpenAI examples.ext-apps examplesFor lower-level or more portable MCP Apps baselines.Environment and dependencies
build-chatgpt-app. The package includes SKILL.md, seven reference guides, the fallback script and an agents/openai.yaml interface file.$openai-docs Skill. Otherwise the assistant uses the OpenAI developer docs MCP server (developers.openai.com/mcp, streamable HTTP). If search fails, it fetches the canonical Apps SDK pages by URL.@modelcontextprotocol/ext-apps, @modelcontextprotocol/sdk, zod, tsx, typescript and @types/node.No separate OpenAI API key is needed to generate a local starter. That does not make the whole workflow free. Your assistant’s model usage, ChatGPT account features, tunnelling, hosting and any paid APIs your app calls can each carry their own costs or requirements.
Fit
What has been verified
All 11 original Skill files match their pinned upstream SHA-256 hashes. The bundled script passed a Node syntax check and generated the four expected starter files. npm dependency installation timed out, so compilation, the local MCP endpoint and live ChatGPT behavior remain unverified. The Benchmark page has the full evidence trail.