Agent skill

Skybridge

by alpic-ai in alpic-ai/skybridge

Guide developers through creating and updating ChatGPT plugins and MCP Apps.

MITAuto-check passedAgent Workflows

Install Skybridge

skills CLI
$ npx skills add alpic-ai/skybridge --skill skybridge -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alpic-ai/skybridge skybridge --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alpic-ai/skybridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skybridge .claude/skills/skybridge && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skybridge
GitHub stars
2.1k
Token cost
~923 tokens
SKILL.md length
344 words
Files
2
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Guide developers through creating and updating ChatGPT plugins and MCP Apps.

  • Works in 3 steps: Copy template → copy-template.md: when… → Run locally → run-locally.md: when ready… → Evals → evals.md: when checking that a…
  • A user wants to create
  • SKILL.md covers Setup, Architecture, Implementation and Deploy
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skybridge is an agent skill from alpic-ai/skybridge. Guide developers through creating and updating ChatGPT plugins and MCP Apps. Covers the full lifecycle: brainstorming ideas against UX guidelines, bootstrapping projects, implementing tools/views, debugging, running dev servers, deploying and connecting them to ChatGPT. Use when a user wants to create or update a ChatGPT plugin, MCP App, MCP server or use the Skybridge framework.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Agent Workflows, covering MCP servers and Brainstorming. It works with Model Context Protocol, OpenAI, React and TypeScript. The repository describes itself as: Skybridge is a full-stack TypeScript framework for MCP Apps and ChatGPT Apps. Type-safe. React-powered. Platform-agnostic. The licence is MIT.

When your agent uses it

  • A user wants to create
  • Update a ChatGPT plugin
  • Use the Skybridge framework

Example prompts

  • “/skybridge”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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, use devtools to render views or connect to ChatGPT/Claude
  3. Evals → evals.md: when checking that a real model reaches the right tools from natural prompts, in a test

What it can do on your machine

Read from SKILL.md and the folder at commit 6dd4439. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.skybridge.tech
    • skybridge.tech

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skybridge loads about 923 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 344 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~923

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alpic-ai/skybridge at commit 6dd4439, republished under its MIT licence (© alpic-ai). 344 words, ~923 tokens.

Download SKILL.mdSave it as .claude/skills/skybridge/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
skybridge
description
Guide developers through creating and updating ChatGPT plugins and MCP Apps. Covers the full lifecycle: brainstorming ideas against UX guidelines, bootstrapping projects, implementing tools/views, debugging, running dev servers, deploying and connecting them to ChatGPT. Use when a user wants to create or update a ChatGPT plugin, MCP App, MCP server or use the Skybridge framework.

Creating Plugins For LLMs

Those are conversational experiences that extend AI assistants 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 AI Assistant 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.

Migrating from Skybridge 1.x to 2.x? → Fetch the v2.0.0 release notes first and follow them.

Building an ecommerce app? → Read ecommerce.md first.

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, use devtools to render views or connect to ChatGPT/Claude
  3. Evals → 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

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
  • Download file → download-file.md: when saving content to the user's filesystem
  • 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/Claude Directories → 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

© alpic-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/skybridge of alpic-ai/skybridge.

  • SKILL.md
  • references

Open the folder on GitHubat commit 6dd4439

Compare with similar skills

Skybridge next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skybridge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skybridge this skillalpic-ai/skybridge2.1k—~923Automated safety check: PassMIT
Nextcrmpdovhomilja/nextcrm-app713—~3.3kAutomated safety check: PassMIT
MCP Server Builder with mcp-usemcp-use/mcp-use11k—~923Automated safety check: PassApache-2.0
Agent RecallGoldentrii/AgentRecall-X371—~5.2kAutomated safety check: NotesMIT
Plugin AuthoringXiaoPuOuO/openchatx-mcp257—~709Automated safety check: PassMIT
GitHub Commentingjuspay/neurolink144—~698Automated safety check: PassMIT

Similar skills

  • Nextcrm

    pdovhomilja/nextcrm-app

    Connect to NextCRM MCP server to manage CRM data — accounts, contacts, leads, opportunities, targets, products, contracts, activities, documents, target lists, enrichment, email accounts, campaigns…

    713 GitHub stars~3.3k tokensUpdated today
    Sales & SupportAuto-check passed
  • Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.

    11k GitHub stars~923 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent Recall

    Goldentrii/AgentRecall-X

    Persistent compounding memory for AI agents. An agent skill from Goldentrii/AgentRecall-X.

    371 GitHub stars~5.2k tokensUpdated 12 days ago
    Agent WorkflowsAuto-check: notes
  • Plugin Authoring

    XiaoPuOuO/openchatx-mcp

    Create or revise openchatx-mcp Toolbox plugins and TypeScript tools from a user's natural-language request.

    257 GitHub stars~709 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • GitHub Commenting

    juspay/neurolink

    How to post clean, rich, deduplicated GitHub PR review comments — suggestion blocks, multi-line anchors, markers, formatting rules.

    144 GitHub stars~698 tokensUpdated today
    DevelopmentAuto-check passed
  • Magic Resume

    Magic-Resume/Magic-Resume

    How AI agents integrate with Magic Resume — read and safely edit a user's resumes through the native MCP server (@magic-resume/mcp).

    101 GitHub stars~663 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed

More from alpic-ai/skybridge

  • Chatgpt App Builder

    alpic-ai/skybridge

    Guide developers through creating and updating ChatGPT plugins.

    2.1k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • MCP App Builder

    alpic-ai/skybridge

    Guide developers through creating and updating MCP Apps. An agent skill from alpic-ai/skybridge.

    2.1k GitHub stars~906 tokensUpdated yesterday
    Auto-check passed

Questions about Skybridge

What does Skybridge do?

Guide developers through creating and updating ChatGPT plugins and MCP Apps. Skybridge is an agent skill from alpic-ai/skybridge. Guide developers through creating and updating ChatGPT plugins and MCP Apps.

When should I use Skybridge?

Skybridge fits situations like: A user wants to create; update a ChatGPT plugin; use the Skybridge framework.

How do I install Skybridge in Claude Code?

Run `npx skills add alpic-ai/skybridge --skill skybridge -a claude-code`. Or copy the skill folder (skills/skybridge in alpic-ai/skybridge) into .claude/skills/skybridge in your project. Claude Code loads it when a task matches its description.

How do I install Skybridge in Codex?

Run `npx skills add alpic-ai/skybridge --skill skybridge -a codex`. Or copy the skill folder (skills/skybridge in alpic-ai/skybridge) into .agents/skills/skybridge in your project. Codex loads it when a task matches its description.

Can I use Skybridge in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alpic-ai/skybridge --skill skybridge -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skybridge, .gemini/skills/skybridge, .github/skills/skybridge and .opencode/skills/skybridge in your project.

What does Skybridge need to run?

SKILL.md names no scripts, command-line tools or credentials: Skybridge is instructions for the agent only.

Does Skybridge access the network?

SKILL.md names 2 domains. As links in the text: docs.skybridge.tech and skybridge.tech. This is read from the text; nothing was executed.

Is Skybridge safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skybridge use?

Skybridge is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skybridge use?

About 923 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skybridge?

Skills that share tags, products or a category with Skybridge: Nextcrm (pdovhomilja/nextcrm-app, 713 stars), MCP Server Builder with mcp-use (mcp-use/mcp-use, 11k stars), Agent Recall (Goldentrii/AgentRecall-X, 371 stars) and Plugin Authoring (XiaoPuOuO/openchatx-mcp, 257 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skybridge?

alpic-ai (a GitHub organization) maintains it in alpic-ai/skybridge, which has 2,150 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 8, 2026.

Source: alpic-ai/skybridge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.