AugmentClaude

chatgpt-app-builder

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.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up β€” so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/chatgpt-app-builder-alpic-ai/ β€” the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates β€” they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description β€” no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the β€œWhat this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

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.

What this skill does

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.

No SPEC.md? β†’ Read discover.md first. Nothing else until SPEC.md exists.

SPEC.md exists? β†’ Read SPEC.md, then follow 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 first. Users may reference skybridge >= 0.36.x as v1.

Setup

  1. Copy template β†’ copy-template.md: when starting a new project with ready SPEC.md
  2. Run locally β†’ run-locally.md: when ready to test, need dev server or ChatGPT connection

Architecture

Design or evolve UX flows and API shape β†’ architecture.md

Implementation

  • Fetch and render data β†’ fetch-and-render-data.md: when implementing server handlers and view data fetching
  • State and context β†’ state-and-context.md: when persisting view UI state and updating LLM context
  • Prompt LLM β†’ prompt-llm.md: when view needs to trigger LLM response
  • UI guidelines β†’ ui-guidelines.md: display modes, layout constraints, theme, device, and locale
  • External links β†’ open-external-links.md: when redirecting to external URLs or setting "open in app" target
  • OAuth β†’ oauth.md: when tools need user authentication to access user-specific data
  • CSP β†’ csp.md: when declaring allowed domains for fetch, assets, redirects, or iframes

Deploy

  • Ship to production β†’ deploy.md: when ready to deploy via Alpic
  • Publish to ChatGPT Directory β†’ 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

Related skills