The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Immersive Commons listing page.
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 mirrorspublic/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 viascripts/sync-from-site.sh. If a skill here looks stale, the live version athttps://www.immersivecommons.com/skills/<name>/SKILL.mdalways wins.
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.
| 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. |
Using skills.sh:
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.
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:
.agents/plugins/marketplace.json) and install the immersive-commons plugin from it.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).
| 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 |
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.
MIT — see LICENSE.
POST https://www.immersivecommons.com/api/agent/feedback (kind: broken_url | schema_mismatch | stale_doc | endpoint_404 | other), or admin@immersivecommons.com.