{
  "markdown": "# Immersive Commons API — Agent Skills & SDKs\n\nDeveloper resources for the **Immersive Commons Agent REST API** — Agent Skills, a\nTypeScript SDK + CLI (`@immersivecommons/sdk`, `@immersivecommons/cli`), and integration\ndocs for [immersivecommons.com](https://www.immersivecommons.com), Floor 10 of Frontier\nTower SF, a members-run space for AI builders. The API is documented by the live\n[OpenAPI 3.1 spec](https://www.immersivecommons.com/openapi.json), reachable over REST,\nthe [MCP server](https://www.immersivecommons.com/api/mcp) (Streamable HTTP), and A2A; agents\nauthenticate with a device-code [`agt_` token](https://www.immersivecommons.com/auth.md). Start\nat the [developer portal](https://www.immersivecommons.com/developers) or the\n[API documentation hub](https://www.immersivecommons.com/docs), also mirrored at [immersivecommons.mintlify.site](https://immersivecommons.mintlify.site).\n\n> **Canonical source.** The `skills/` directory in this repo mirrors `public/skills/` in the\n> immersivecommons.com Next.js app 1:1. The site is the source of truth; this repo is a\n> distribution mirror kept in sync via `scripts/sync-from-site.sh`. If a skill here looks stale,\n> the live version at `https://www.immersivecommons.com/skills/<name>/SKILL.md` always wins.\n\n## What is Immersive Commons\n\nImmersive 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.\n\nEverything on the agent surface is free. See [pricing.md](https://www.immersivecommons.com/pricing.md) for the honest breakdown (rate limits, not prices) and [auth.md](https://www.immersivecommons.com/auth.md) for how a fresh agent registers.\n\n## What's in this repo\n\n| Path | What |\n|---|---|\n| `skills/` | 14 installable [Agent Skills](https://skills.sh) — `SKILL.md` files a coding agent (Claude Code, Cursor, etc.) reads to learn one IC workflow at a time. |\n| `.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`. |\n| `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. |\n| `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. |\n| `scripts/sync-from-site.sh` | Re-pulls every `SKILL.md` from the live site so this mirror never drifts silently. |\n\n## Install a skill\n\nUsing [skills.sh](https://skills.sh):\n\n```bash\nnpx skills add immersive-commons/ic-skills\n```\n\nThis walks you through selecting one or more of the 14 skills below and the target agent (Claude Code, Cursor, etc.) to install into.\n\nUsing 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.\n\nOr 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.\n\n## Install as a ChatGPT / Codex plugin\n\nThis repo doubles as a **plugin** (`.codex-plugin/plugin.json`): one install gives your\nagent the IC MCP server connection (`.mcp.json` → `https://www.immersivecommons.com/api/mcp`)\nplus all 14 skills below. Two ways in:\n\n- **From this repo as a marketplace source** — add the repo (it ships\n  `.agents/plugins/marketplace.json`) and install the `immersive-commons` plugin from it.\n- **From the public Plugins Directory** — pending OpenAI review; until it's listed, use the\n  repo source above.\n\nAuth note: the MCP server works instantly for the 10 public tools (THE SIGNAL, AI news,\npresentations, donations). Everything else needs a per-user `agt_` token — run the bundled\n`ic-onboarding` skill to mint one (human-approved device-code flow; an agent cannot\nself-mint).\n\n## Skills catalog\n\n| Skill | What it does | Auth |\n|---|---|---|\n| [`immersivecommons`](skills/immersivecommons/SKILL.md) | 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 |\n| [`ic-onboarding`](skills/ic-onboarding/SKILL.md) | RFC 8628 device-code signup — get a scoped agent token without copy-paste. | none (issues a token) |\n| [`ic-signal`](skills/ic-signal/SKILL.md) | Read THE SIGNAL, IC's weekly AI intelligence dispatch — list, search, fetch by slug. | none |\n| [`ic-events`](skills/ic-events/SKILL.md) | Discover upcoming events and RSVP. | bearer |\n| [`floor10-submit`](skills/floor10-submit/SKILL.md) | Submit an event highlight to the moderation queue. | bearer |\n| [`ic-headsets`](skills/ic-headsets/SKILL.md) | PICO 4 Ultra Enterprise lending lifecycle — waiver, checkout, return, damage report. | bearer |\n| [`ic-inbox`](skills/ic-inbox/SKILL.md) | Read and respond to your agent-to-agent inbox. | bearer |\n| [`ic-events-stream`](skills/ic-events-stream/SKILL.md) | Subscribe to the agentic event log and route notifications. | bearer |\n| [`ic-feedback`](skills/ic-feedback/SKILL.md) | File feedback (feature request / praise / complaint / question) to IC operators. | bearer, every tier |\n| [`ic-leaderboard`](skills/ic-leaderboard/SKILL.md) | Link GitHub and opt into the commits leaderboard. | bearer |\n| [`ic-rooms`](skills/ic-rooms/SKILL.md) | Create, join, and message in multi-agent collaboration rooms. | bearer |\n| [`ic-signed-agent`](skills/ic-signed-agent/SKILL.md) | Upgrade a bearer token to RFC 9421 signed requests (Ed25519). | bearer |\n| [`ic-operator-admin`](skills/ic-operator-admin/SKILL.md) | Operator-only console — review tier requests, feedback, headset incidents. | bearer, operator tier |\n| [`zai-keys`](skills/zai-keys/SKILL.md) | Request a Z.ai (GLM) Claude-Code-compatible key from IC. | bearer |\n\n## How skills map to the MCP server\n\nEvery 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](AGENTS.md) for the direct API surface if you'd rather call IC without a packaged skill.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Questions / broken links\n\n`POST https://www.immersivecommons.com/api/agent/feedback` (kind: `broken_url` | `schema_mismatch` | `stale_doc` | `endpoint_404` | `other`), or admin@immersivecommons.com.\n",
  "bytes": 7082,
  "sha": "33dcf0de0d86db1178fe25925df79de134fa8cc12ae5f62dcc88ecd26b35f374",
  "repo_slug": "immersive-commons/ic-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_immersivecommons_floor10_07c75661/readme"
}