Agent skill · OpenAI

ChatGPT Apps skill for Claude Code, Codex and Cursor

Scaffolds and debugs ChatGPT apps built with the Apps SDK: an MCP server plus widget UI.

Officialname: chatgpt-apps★ 28k (repo)pushed 2026-09-08Apache-2.0SKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install ChatGPT Apps

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add openai/skills --skill chatgpt-apps

Copy the skill folder into ~/.claude/skills (all projects) or .claude/skills (this repo). Claude Code picks it up without a restart. docs

npx skills add openai/skills --skill chatgpt-apps -a claude-code

# or by hand:
git clone --depth 1 https://github.com/openai/skills.git /tmp/chatgpt-apps-src
cp -r /tmp/chatgpt-apps-src/skills/.curated/chatgpt-apps ~/.claude/skills/chatgpt-apps

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/openai/skills.git /tmp/chatgpt-apps-src
cp -r /tmp/chatgpt-apps-src/skills/.curated/chatgpt-apps ./chatgpt-apps
zip -r chatgpt-apps.zip chatgpt-apps

It's in OpenAI's own catalog: ask Codex for $skill-installer chatgpt-apps, or use the skills CLI. docs

$skill-installer chatgpt-apps

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install openai/skills chatgpt-apps

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add openai/skills --skill chatgpt-apps -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/openai/skills.git --path skills/.curated/chatgpt-apps

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add openai/skills --skill chatgpt-apps -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add openai/skills --skill chatgpt-apps -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

Bundles 1 JavaScript script the agent can run, so it needs JavaScript on the machine. In the Claude apps, code execution must be on.

What's in the SKILL.md

22 sections

Overview
Mandatory Docs-First Workflow
Prompt Guidance
Classify The App Before Choosing Code
Default Starting-Point Order
Build Workflow
0. Classify The App Archetype
1. Plan Tools Before Code
2. Choose an App Architecture
2a. Start From An Upstream Example When One Fits
2b. Use the Starter Script When a Low-Dependency Fallback Helps
3. Scaffold the MCP Server
4. Scaffold the Widget UI
5. Add Resource Metadata and Security
5a. Enforce A Minimum Working Repo Contract
6. Validate the Local Loop
7. Connect and Test in ChatGPT (Developer Mode)
8. Plan Production Hosting and Deployment
9. Prepare Submission and Publish (Public Apps Only)
Interactive State Guidance
Output Expectations
References

Bundled files

LICENSE.txt
agents/openai.yaml
references/app-archetypes.md
references/apps-sdk-docs-workflow.md
references/interactive-state-sync-patterns.md
references/repo-contract-and-validation.md
references/search-fetch-standard.md
references/upstream-example-workflow.md
references/window-openai-patterns.md
scripts/scaffold_node_ext_apps.mjs

Loaded only when the instructions point to them.

Facts

Skill name: chatgpt-apps
Publisher: OpenAI (official)
Repo: openai/skills
License: Apache-2.0
SKILL.md size: 2,632 words, 316 lines
Bundled files: 10, 1 scripts (JavaScript), 7 docs
Repo stars: 28k (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the OpenAI MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from openai/skills

GitHub: Address PR Comments: Works through review comments on the current branch's pull request using the gh CLI.
GitHub: Fix CI: Reads failing GitHub Actions checks with gh, summarizes the cause and proposes a fix.
Image Generation: Generates or edits raster images such as illustrations, sprites, mockups and transparent cutouts.
Linear: Reads, creates and updates Linear issues and projects from the agent.
OpenAI Docs: Looks up current OpenAI API and Codex documentation and helps pick a model.
Playwright Browser Automation: Automates a real browser from the terminal for form filling, snapshots, scraping and UI debugging.
Security Best Practices Review: Reviews code for language- and framework-specific security issues and suggests safer defaults.
Security Threat Model: Writes a threat model for a repository: trust boundaries, assets, attack paths and mitigations.
Skill Installer (Codex): Codex's built-in helper that installs skills from the curated list or any GitHub repo path.

Related ai & ml skills

Claude API · Anthropic
Hugging Face CLI · Hugging Face
Gradio · Hugging Face
Hugging Face LLM Trainer · Hugging Face
Transformers.js · Hugging Face
Gemini API · Google (Gemini)
Gemini Live API · Google (Gemini)
Cloudflare Agents SDK · Cloudflare

FAQ

What does the chatgpt-apps skill do?+

Scaffolds and debugs ChatGPT apps built with the Apps SDK: an MCP server plus widget UI. In its own SKILL.md, OpenAI describes it as: "Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI."

How do I install the chatgpt-apps skill?+

Run npx skills add openai/skills --skill chatgpt-apps and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/chatgpt-apps/SKILL.md; in Codex and Cursor in .agents/skills/chatgpt-apps/.

Does ChatGPT Apps work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains ChatGPT Apps?+

OpenAI, the company or project behind it, in the openai/skills repo on GitHub, last pushed 2026-09-08. License: Apache-2.0.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers