skybridge AGENTS.md

skybridge AGENTS.md is an instructions file for Codex, OpenCode from alpic-ai/skybridge. It costs 746 tokens per session, scanned A, original, MIT.

Project instructions for Skybridge, a TypeScript framework for building interactive apps that run inside AI conversations. It explains how a server exposes tools and how React views display their results.

In plain words
What is it for?
Use it when developing, navigating, or validating Skybridge's server, frontend, framework packages, and documentation.
Why use it?
It gives contributors a shared explanation of the framework and its code layout, including its monorepo. A monorepo is one repository containing several related packages.

Instructions file for CodexOpenCode

About the project

alpic-ai/skybridge is a full-stack TypeScript and React framework for building MCP apps, which are interactive user interfaces connected to MCP servers and usable in clients such as Claude and ChatGPT. It helps developers create type-safe apps with development tooling, client compatibility, React hooks, and agent-oriented APIs. The catalogue skills, instructions, setting, and hook support workflows for building MCP apps with Skybridge.

alpic-ai/skybridge · 1,991 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/alpic-ai/skybridge/agents-md
Clone the repo
git clone --depth 1 https://github.com/alpic-ai/skybridge

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for skybridge AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/alpic-ai/skybridge/agents-md.svg)](https://agentmods.dev/instructions/alpic-ai/skybridge/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/alpic-ai/skybridge/agents-md"><img src="https://agentmods.dev/badge/instructions/alpic-ai/skybridge/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 746 This file is loaded in full into every session.
When invoked 746 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00746 $0.00746
Opus 5 $0.00373 $0.00373
Sonnet 5 $0.00149 $0.00149
Haiku 4.5 $0.00075 $0.00075

Measured 5d ago against content hash ebc1e01b0948, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

skybridge AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 80 lines

How it starts

The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agents Guide

What is Skybridge

Skybridge is a fullstack TypeScript framework for building ChatGPT Apps and MCP Apps — interactive React views that render inside AI conversations.

The core loop: an MCP server exposes tools. When the host (ChatGPT, Claude, VSCode…) calls a tool, the server returns structured data and a reference to a React view. The host renders that view in an iframe. The view can read tool output, call other tools, send follow-up messages, and sync UI state back to the model.

Skybridge wraps two host runtimes behind one API:

  • Apps SDK — ChatGPT's proprietary window.openai runtime
  • MCP Apps — the open ext-apps spec (JSON-RPC postMessage)

Developers write one server (backend) and view(s) (frontend). Skybridge detects the runtime at load time.

For deep understanding, read docs/home.mdx, docs/fundamentals/, and docs/concepts/.

Monorepo layout

packages/
  core/             # npm: `skybridge` — the framework
    src/server/     #   MCP server (extends @modelcontextprotocol/sdk), view registration, Express
    src/web/        #   React hooks, runtime adaptors, data-llm, Vite plugin, createStore
    src/cli/        #   CLI entry (oclif)
    src/commands/   #   dev / build / start commands
  devtools/         # npm: @skybridge/devtools — local emulator UI
  create-skybridge/ # npm create skybridge — project scaffolder
 
examples/           # Showcase apps — good for understanding patterns
docs/               # Mintlify site (docs.skybridge.tech)
skills/             # Coding agents skills for guided app building

When you need to understand a concept, read the corresponding docs/ page or the source in packages/core/src/.

Development

Prerequisites: Node.js >= 24.14.0, pnpm 10+ (corepack enable).

pnpm install        # setup

Validation

pnpm test           # unit tests (vitest) + lint (biome ci)
pnpm build          # compile all packages

Per-package:

pnpm --filter skybridge test:unit
pnpm --filter skybridge test:format
pnpm --filter skybridge build

Read the full file on GitHub · 80 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 80 lines · 746 tokens per session scan A ebc1e01b0948

Subscribe to this mod's changes

skybridge AGENTS.md is an instructions file published in the GitHub repository alpic-ai/skybridge (1,991 stars, last pushed 4d ago), licensed MIT. It adds 746 tokens to every session, about $0.0037 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

awesome-ChatGPT-repositories CLAUDE.md

Claude Code instructions for taishi-i/awesome-ChatGPT-repositories, covering awesome-chatgpt-repositories — claude code guide, repository structure, plugin skill (when installed via /plugin), local standalone command (when repo is cloned) and compact data format (plugins/awesome-chatgpt-search/data/).

taishi-i/awesome-ChatGPT-repositories · 995 tokens

dsh-chat-import AGENTS.md

Instructions for Nwflower/dsh-chat-import, covering agents.md, 背景, 命令, 仓库布局 and 编码.

Nwflower/dsh-chat-import · 1,557 tokens

webcodex AGENTS.md

Instructions for yyjeqhc/webcodex, covering agents.md — webcodex repository guide, v1 active development, 1. verify and preserve, 2. build the simplest useful product and 3. follow intent and make focused changes.

yyjeqhc/webcodex · 2,294 tokens

Proma AGENTS.md

AGENTS.md instructions for proma-ai/Proma, covering proma 工程约定, 必须遵守, 常用命令, 开发 and 构建 / 类型检查 / 测试.

proma-ai/Proma · 1,099 tokens

OpenHands AGENTS.md

AGENTS.md instructions for OpenHands/OpenHands, covering repository notes, general, repository map — what belongs where, cross-repository boundaries and pr description human check.

OpenHands/OpenHands · 28,090 tokens

mcp-app-typescript-template AGENTS.md

AGENTS.md instructions for pomerium/mcp-app-typescript-template, covering repository guidelines, project overview, development commands, quick start and all available commands.

pomerium/mcp-app-typescript-template · 5,171 tokens