chatgpt-apps

Classify app archetypes and scaffold ChatGPT Apps SDK projects from current docs.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/bzellman/earp-kit --skill chatgpt-apps-bzellman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chatgpt-apps
Source: https://github.com/bzellman/earp-kit/tree/main/skills/system/chatgpt-apps
Command: npx skills add https://github.com/bzellman/earp-kit --skill chatgpt-apps-bzellman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffolds, refactors, and troubleshoots ChatGPT Apps SDK projects that combine an MCP server and a 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. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.

Core Features & Use Cases

  • Docs-first workflow guidance for building and aligning Apps SDK implementations
  • Archetype-driven scaffolding of MCP server and widget structures
  • CSP and domain metadata integration with resource registration and validation

Quick Start

Invoke the OpenAI Docs workflow, fetch current Apps SDK docs, classify the app archetype, and scaffold a minimal MCP server and widget using the closest upstream example.

Frequently Asked Questions about chatgpt-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a ChatGPT App with an MCP server and widget UI?

To scaffold a ChatGPT App, classify your app archetype and generate a runnable MCP server and widget UI repo. The workflow fetches current Apps SDK docs to ensure the project structure aligns with the upstream contract and metadata validation.

What is a docs-first workflow for building ChatGPT Apps SDK projects?

A docs-first workflow means fetching the latest Apps SDK documentation before generating any code. This ensures your MCP server tool definitions and widget UI resource registrations match current OpenAI developer docs rather than outdated examples.

Can I use this approach for greenfield planning and production scaffolds?

Yes, archetype-driven scaffolding applies to both greenfield planning and production builds. It enforces archetype selection and generates a runnable repository that adheres to the Apps SDK contract for MCP server and widget structures.

How do I configure CSP and domain metadata for a ChatGPT widget?

Configuring CSP and domain metadata involves integrating these settings during the resource registration and validation phase. The scaffolding process applies Apps SDK metadata constraints to ensure your widget UI complies with required security policies.

What's the best way to define tools and register resources for an MCP server?

The best way to define tools and register resources is by selecting the closest upstream example as a template. The scaffolder fetches current docs, applies archetype selection, and generates compliant MCP server tool definitions.

Why does my ChatGPT App scaffold fail metadata validation?

Metadata validation fails when the generated repo does not adhere to the Apps SDK contract. Fetching current OpenAI developer docs before scaffolding ensures your CSP settings, domain configurations, and resource registrations meet the required standards.