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

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

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 admin@immersivecommons.com.