--- title: "chatgpt-app-builder by alpic-ai · skilld" canonical_url: "https://skilld.dev/gh/alpic-ai/skybridge" meta: description: "Guides developers through the complete lifecycle of building ChatGPT apps—from ideation and project setup through implementation, debugging, and deployment to the ChatGPT… From alpic-ai/skybridge." "og:description": "Guides developers through the complete lifecycle of building ChatGPT apps—from ideation and project setup through implementation, debugging, and deployment to the ChatGPT… From alpic-ai/skybridge." "og:title": "chatgpt-app-builder by alpic-ai" "twitter:description": "Guides developers through the complete lifecycle of building ChatGPT apps—from ideation and project setup through implementation, debugging, and deployment to the ChatGPT… From alpic-ai/skybridge." "twitter:title": "chatgpt-app-builder by alpic-ai" --- ` [All skills](https://skilld.dev/skills) [![alpic-ai avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Falpic-ai.png%3Fsize%3D96)](https://skilld.dev/gh/alpic-ai) # **/chatgpt-app-builder** [@3340b34](https://github.com/alpic-ai/skybridge/commit/3340b3429fb40ccd14196b3e351f54f46d411a88 "Your agent reads SKILL.md at commit 3340b34") by [Alpic](https://skilld.dev/gh/alpic-ai)· [alpic-ai](https://skilld.dev/gh/alpic-ai)/ [skybridge](https://skilld.dev/gh/alpic-ai/skybridge)·2.1k stars 140 Guide developers through creating and updating ChatGPT apps. Covers the full lifecycle: brainstorming ideas against UX guidelines, bootstrapping projects, implementing tools/views, debugging, running dev servers, deploying and connecting apps to ChatGPT. Use when a user wants to create or update a ChatGPT app / MCP server for ChatGPT, or use the Skybridge framework. - 29 files - 121.5 KB - Updated last week - [GitHub](https://github.com/alpic-ai/skybridge/blob/3340b3429fb40ccd14196b3e351f54f46d411a88/skills/chatgpt-app-builder/SKILL.md "View SKILL.md on GitHub") - [1 alert](#third-party-checks "Third-party checks: 1 alert · 5 checks · Risk SAFE") ## SKILL.md 3.6 KB **≈97** tokens always: the name and description. **≈816** when used: this file. **≈30k** more on demand in 28 files. ## Creating Apps For LLMs ChatGPT apps are conversational experiences that extend ChatGPT through tools and custom UI views. They're built as MCP servers invoked during conversations. ⚠️ The app is consumed by two users at once: the **human** and the **ChatGPT LLM**. They collaborate through the view—the human interacts with it, the LLM sees its state. Internalize this before writing code: the view is your shared surface. SPEC.md keeps track of the app's requirements and design decisions. Keep it up to date as you work on the app. **Building an ecommerce app?** → Read [ecommerce.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/ecommerce.md) first. **No SPEC.md?** → Read [discover.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/discover.md) first. Nothing else until SPEC.md exists. **SPEC.md exists?** → Read SPEC.md, then follow [architecture.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/architecture.md) to design the change. Update SPEC.md, then read the relevant Implementation references below before writing code. **Migrating from Skybridge `< 0.36.x`?** → Read [migrate-to-v1.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/migrate-to-v1.md) first. Users may reference `skybridge >= 0.36.x` as v1. **Migrating from Skybridge `1.x` to `2.x`?** → Fetch the [v2.0.0 release notes](https://github.com/alpic-ai/skybridge/releases/tag/v2.0.0) first and follow them. ### Setup 1. **Copy template** → [copy-template.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/copy-template.md): when starting a new project with ready SPEC.md 2. **Run locally** → [run-locally.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/run-locally.md): when ready to test, need dev server or ChatGPT connection 3. **Evals** → [evals.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/evals.md): when checking that a real model reaches the right tools from natural prompts, in a test ### Architecture Design or evolve UX flows and API shape → [architecture.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/architecture.md) ### Implementation - **Fetch and render data** → [fetch-and-render-data.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/fetch-and-render-data.md): when implementing server handlers and view data fetching - **State and context** → [state-and-context.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/state-and-context.md): when persisting view UI state and updating LLM context - **Prompt LLM** → [prompt-llm.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/prompt-llm.md): when view needs to trigger LLM response - **UI guidelines** → [ui-guidelines.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/ui-guidelines.md): display modes, layout constraints, theme, device, and locale - **External links** → [open-external-links.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/open-external-links.md): when redirecting to external URLs or setting "open in app" target - **OAuth** → [oauth.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/oauth.md): when tools need user authentication to access user-specific data - **Assets and styling** → [assets-and-styling.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/assets-and-styling.md): when adding images, fonts or CSS to views - **CSP** → [csp.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/csp.md): when declaring allowed domains for fetch, assets, redirects, or iframes ### Deploy - **Ship to production** → [deploy.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/deploy.md): when ready to deploy via Alpic - **Publish to ChatGPT Directory** → [publish.md](https://skilld.dev/gh/alpic-ai/skybridge/chatgpt-app-builder/-/references/publish.md): when ready to submit for review Full API docs: https://docs.skybridge.tech/api-reference.md Release notes & changelog: https://skybridge.tech/changelog.md Source: [SKILL.md on GitHub](https://github.com/alpic-ai/skybridge/blob/3340b3429fb40ccd14196b3e351f54f46d411a88/skills/chatgpt-app-builder/SKILL.md) ## Third-party checks
1 alert6d5 checks · Risk SAFE - Gen Agent Trust Hub6d The skill is a comprehensive development guide for the Skybridge framework, which helps build ChatGPT applications. It is generally safe and follows security best practices, such as documenting CSP and OAuth configurations. It identifies a minor risk of indirect prompt injection as it processes user-provided specification files to guide the development process. - Socket6d No alerts - Snyk6d Risk: LOW · No issues - Runlayer7mo 8/23 files flagged - ZeroLeaks5mo Score: 93/100 · 2 sections analyzed
## Provenance [Signed by skilld at 3340b34.](https://github.com/alpic-ai/skybridge/commit/3340b3429fb40ccd14196b3e351f54f46d411a88 "3340b3429fb40ccd14196b3e351f54f46d411a88") This ties the file your Agent reads to that commit on GitHub. It does not review the instructions. Last checked against GitHub 2 days ago. Activeupdated last week ## Topics - [MCP](https://skilld.dev/skills/tag/mcp "Model Context Protocol servers/clients") - [TypeScript](https://skilld.dev/skills/tag/typescript "Type-heavy workflows, generics, type audits") - chatgpt - app-builder - llm - ui - oauth - deployment - skybridge ## README badge ![README badge for alpic-ai/skybridge](https://skilld.dev/b/alpic-ai/skybridge?theme=light&label=0) ## What it does Guides developers through the complete lifecycle of building ChatGPT apps—from ideation and project setup through implementation, debugging, and deployment to the ChatGPT Directory. Covers the Skybridge MCP server framework, tool integration, custom UI views, state management, OAuth, and the dual-user model where both the human and ChatGPT LLM interact with the same view. Generated from the current SKILL.md. ## Frequently asked
What is a ChatGPT app and how does it work? A ChatGPT app is a conversational experience that extends ChatGPT through tools and custom UI views, built as an MCP server. The view serves as a shared surface where both the human user and the ChatGPT LLM interact and collaborate.
Do I need a SPEC.md file before building? Yes. You should read discover.md first to create a SPEC.md that documents your app's requirements and design decisions before implementing anything.
What does this skill cover? The skill guides the full lifecycle: brainstorming ideas against UX guidelines, bootstrapping projects, implementing tools and views, debugging, running dev servers, deploying via Alpic, and publishing to the ChatGPT Directory.
Does this skill provide API documentation? Yes. Full API docs are available at https://docs.skybridge.tech/api-reference.md, and the skill includes implementation references for specific tasks like OAuth, state management, and CSP configuration.
Generated from the current SKILL.md. These answers refresh after source changes. ## Related skills - - - - - -