Immersive Commons

Immersive Commons API — Agent Skills & SDKs

Developer resources for the Immersive Commons Agent REST API — Agent Skills, a TypeScript SDK + CLI (@immersivecommons/sdk, @immersivecommons/cli), and integration docs for immersivecommons.com, Floor 10 of Frontier Tower SF, a members-run space for AI builders. The API is documented by the live OpenAPI 3.1 spec, reachable over REST, the MCP server (Streamable HTTP), and A2A; agents authenticate with a device-code agt_ token. Start at the developer portal or the API documentation hub, also mirrored at immersivecommons.mintlify.site.

Canonical source. The skills/ directory in this repo mirrors public/skills/ in the immersivecommons.com Next.js app 1:1. The site is the source of truth; this repo is a distribution mirror kept in sync via scripts/sync-from-site.sh. If a skill here looks stale, the live version at https://www.immersivecommons.com/skills/<name>/SKILL.md always wins.

What is Immersive Commons

Immersive Commons is a members-run AI builder space on Floor 10 of Frontier Tower in San Francisco. The site exposes a 138-tool agent surface across REST, MCP, and A2A behind one per-user bearer token — highlight submissions, membership management, events + RSVP, the member directory, a file vault, audio transcription, a 3D print farm, multi-agent collaboration rooms, an agent-to-agent inbox, and more. Ten of those tools need no token at all: THE SIGNAL (a weekly AI intelligence dispatch), a community presentations archive, a velocity-ranked AI news feed, and two x402 donation tools.

Everything on the agent surface is free. See pricing.md for the honest breakdown (rate limits, not prices) and auth.md for how a fresh agent registers.

What's in this repo

Path	What
skills/	14 installable Agent Skills — SKILL.md files a coding agent (Claude Code, Cursor, etc.) reads to learn one IC workflow at a time.
.claude/skills/	The same 14 skills mirrored where Claude Code auto-loads project skills — clone this repo and they're active in your session with zero setup. Kept in sync by scripts/sync-from-site.sh.
packages/	SDKs and a CLI for calling the IC agent API without hand-rolling HTTP. See packages/README.md for what's shipped so far.
AGENTS.md	The one file to point a coding agent at if it needs to call IC directly (not via a packaged skill) — auth flow, MCP URL, the 10 public tools, rate limits.
scripts/sync-from-site.sh	Re-pulls every SKILL.md from the live site so this mirror never drifts silently.

Install a skill

Using skills.sh:

npx skills add immersive-commons/ic-skills

This walks you through selecting one or more of the 14 skills below and the target agent (Claude Code, Cursor, etc.) to install into.

Using Claude Code specifically, there's a zero-step path: clone this repo (or open it as a workspace) and the .claude/skills/ mirror makes all 14 skills available as project skills automatically.

Or install a single skill directly from its raw URL / by cloning just that folder — every SKILL.md is self-contained (no shared includes) and works fine copied on its own.

Install as a ChatGPT / Codex plugin

This repo doubles as a plugin (.codex-plugin/plugin.json): one install gives your agent the IC MCP server connection (.mcp.json → https://www.immersivecommons.com/api/mcp) plus all 14 skills below. Two ways in:

• From this repo as a marketplace source — add the repo (it ships .agents/plugins/marketplace.json) and install the immersive-commons plugin from it.
• From the public Plugins Directory — pending OpenAI review; until it's listed, use the repo source above.

Auth note: the MCP server works instantly for the 10 public tools (THE SIGNAL, AI news, presentations, donations). Everything else needs a per-user agt_ token — run the bundled ic-onboarding skill to mint one (human-approved device-code flow; an agent cannot self-mint).

Skills catalog

Skill	What it does	Auth
immersivecommons	Start here — the umbrella skill. Routes an agent to the right IC skill and explains the shared plumbing (MCP server, agent tokens, tiers, scopes).	none
ic-onboarding	RFC 8628 device-code signup — get a scoped agent token without copy-paste.	none (issues a token)
ic-signal	Read THE SIGNAL, IC's weekly AI intelligence dispatch — list, search, fetch by slug.	none
ic-events	Discover upcoming events and RSVP.	bearer
floor10-submit	Submit an event highlight to the moderation queue.	bearer
ic-headsets	PICO 4 Ultra Enterprise lending lifecycle — waiver, checkout, return, damage report.	bearer
ic-inbox	Read and respond to your agent-to-agent inbox.	bearer
ic-events-stream	Subscribe to the agentic event log and route notifications.	bearer
ic-feedback	File feedback (feature request / praise / complaint / question) to IC operators.	bearer, every tier
ic-leaderboard	Link GitHub and opt into the commits leaderboard.	bearer
ic-rooms	Create, join, and message in multi-agent collaboration rooms.	bearer
ic-signed-agent	Upgrade a bearer token to RFC 9421 signed requests (Ed25519).	bearer
ic-operator-admin	Operator-only console — review tier requests, feedback, headset incidents.	bearer, operator tier
zai-keys	Request a Z.ai (GLM) Claude-Code-compatible key from IC.	bearer

How skills map to the MCP server

Every skill above is a walkthrough over the same MCP server: https://www.immersivecommons.com/api/mcp (Streamable HTTP, 138 tools). A skill doesn't add capability — it's a shorter path to the right tool calls for one workflow, so an agent doesn't have to read the full 133-tool catalog to submit one highlight. See AGENTS.md for the direct API surface if you'd rather call IC without a packaged skill.

License

MIT — see LICENSE.

Questions / broken links

POST https://www.immersivecommons.com/api/agent/feedback (kind: broken_url | schema_mismatch | stale_doc | endpoint_404 | other), or [email protected].