cometchat-skills — Claude Code plugin: what it does, how to install
Adds CometChat text chat, voice, and video calling skills to React, Angular, React Native, iOS, Android, and Flutter projects using the live Docs MCP.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install cometchat-skills@awesome-codex-pluginsWhat cometchat-skills does
The plugin bundles the cometchat router and an onboarding flow that discovers project frameworks, plans integration points, and writes production-ready code directly into your codebase. It supports UI Kit packages across React v7, Angular v5, React Native v5, native iOS v5, Android v6, and Flutter v6, along with headless Calls SDK v5 modules.
Dedicated workflows handle migrations from Sendbird or Stream Chat. The agent branches into cometchat-migration, swaps out components for CometChat counterparts, removes legacy vendor dependencies, and prepares user and history migration scripts. Live task guides are pulled through the CometChat Docs MCP endpoint at https://mcp.cometchat.com/mcp.
Writing code works without live credentials, but running the integrated chat requires obtaining an App ID and Auth Key from the dashboard via @cometchat/skills-cli@3.
What it helps with
- Add ready-made CometChat messaging UI to web and mobile apps
- Implement standalone voice and video calling using Calls SDK
- Migrate chat implementations from Sendbird or Stream Chat
- Fetch current CometChat documentation directly inside the coding agent
Example prompts for the agent
- add chat to my app
- migrate my app to CometChat
- switch to dark mode and add reactions
How to install cometchat-skills
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install cometchat-skills@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about cometchat-skills
How to install cometchat-skills in Claude Code?
Run /plugin marketplace add hashgraph-online/awesome-codex-plugins followed by /plugin install cometchat-skills@awesome-codex-plugins.
What frameworks are covered by cometchat-skills?
It provides UI Kit support for React v7, Angular v5, React Native v5, iOS v5, Android v6, and Flutter v6, plus headless Calls SDK v5 for web and mobile platforms.
How does migration from Sendbird or Stream Chat work?
The agent switches to a cometchat-migration git branch, rewires UI components and webhook endpoints, clears previous vendor code, and provides a data import script.
Source text
cometchat-skills · MIT
# @cometchat/skills (v5)
**Add CometChat chat & calling to your app through your AI coding agent.** Install the skills, then ask your agent *"add chat to my app"* — it has a short conversation with you (framework, intent, placement, credentials), then writes production-grade integration code into the files you already have.
v5 is a **multi-platform** pack: a thin `cometchat` dispatcher + an `onboarding` journey + on-demand, verified skills for six UI Kits — **React v7 · Angular v5 · React Native v5 · iOS v5 · Android v6 · Flutter v6** — plus headless **Calls SDK v5** skills (JavaScript · React Native · iOS · Android · Flutter) and the **Android Chat SDK v5**. It's **docs-maximal** (builds from the official CometChat task guides and verifies against them) and **two-gate tested** (a deterministic reviewer + a black-box acceptance explorer).
> **v5 ships on npm as `@cometchat/skills` (5.x).** It's a multi-platform rewrite of the v4 pack — same package name, new major. Upgrading? `add` removes the old v4 skills for you (see `CHANGELOG.md`).
## Install
```bash
npx @cometchat/skills add
```
The installer **detects your project automatically** — React (Vite, Next.js, CRA, Astro, React Router), Angular, React Native / Expo, and native iOS (Xcode project), Android (Gradle) and Flutter (`pubspec.yaml`) — and installs the skills for your coding agent: **Claude Code by default**; target another with `--ide` (Cursor, Codex, Cline, Kiro, Replit Agent, Windsurf, Copilot, Gemini, …) or `--ide all`. Use `--family` to force a platform (e.g. from a monorepo root) or to add the headless SDK skills **alongside** a UI Kit — a second `add` never removes the first family's skills:
```bash
npx @cometchat/skills add --family flutter # force the Flutter v6 UI Kit skills
npx @cometchat/skills add --family js-calls # add headless JS Calls SDK skills next to the React ones
```
Pin the agent as well (CI / Docker) with `--ide claude|cursor|codex|replit|…` (e.g. `--ide claude` → `.claude/skills/`). The full `--family` list is: `react · angular · react-native · ios · android · flutter` (UI Kits) and `android-sdk · react-native-calls · ios-calls · android-calls · flutter-calls · js-calls` (headless SDKs).
### Or install as a plugin
A plugin install bundles every family's skills with the CometChat Docs MCP (`https://mcp.cometchat.com/mcp`), so the skills read current docs without extra setup.
```bash
# Claude Code
/plugin marketplace add cometchat/cometchat-skills
/plugin install cometchat-skills@cometchat
# Gemini CLI
gemini extensions install https://github.com/cometchat/cometchat-skills
# Any agent that reads Agent Skills (via skills.sh)
npx skills add cometchat/cometchat-skills
```
The repo root also carries an [Agent Plugins 1.0](https://agent-plugins.org) manifest (`plugin.json` + `mcp.json`), the format Cursor, Codex and GitHub Copilot load.
## Use it
After install, open your project in your agent and say:
```
add chat to my app
```
The `cometchat` dispatcher routes to `cometchat-onboarding` (discover → understand → plan → approve), then hands a scoped build directive to that platform's `-core` skill, pulling in the others as the approved plan needs them (components, placement, theming, features, calls, push). Iterate afterward — *"add reactions" · "switch to dark mode" · "add a details side panel" · "switch to server-minted auth tokens"* (production auth — server-minted `loginWithAuthToken` — is covered inside each family's `-core` credentials/lifecycle guidance, and by the dedicated `-production` skill where one exists).
### Migrating from Sendbird or Stream (GetStream)
```
migrate my app to CometChat
```
In a project that uses Sendbird or Stream Chat, this one prompt runs the whole migration, with no plan/approve round-trip. `detect` spots the vendor (`migrate_from`), and `cometchat-migrate-from-sendbird` / `cometchat-migrate-from-getstream` then:
- works on a `cometchat-migration` git branch;
- replaces every supported feature with its CometChat equivalent on your platform's UI Kit or SDK;
- **fully removes** the features CometChat doesn't have (code, UI entry points, dependencies);
- rewires your server's token endpoint and webhooks;
- writes a data-migration script for users, groups and message history and runs it for you once you provide the credentials (after the app migration is done);
- uninstalls the vendor and checks that the build passes.
It ends with `COMETCHAT_MIGRATION.md` and prints two lists: what was removed, and what you still need to do (credentials, dashboard toggles, running the import).
**Full step-by-step guide (prerequisites, install, run, data import, go-live):** [MIGRATING.md](MIGRATING.md).
## Credentials (dashboard CLI)
A separate, dashboard-only CLI fetches your App ID / Region / Auth Key so you don't paste them by hand:
```bash
npx @cometchat/skills-cli@3 auth login
npx @cometchat/skills-cli@3 provision run
```
The CLI is dashboard/API-only (`auth · provision · config · features`) — it never writes framework code; the skills do all detection, env-writing, and codegen.
## What's in the pack
A thin `cometchat` router + a `cometchat-onboarding` journey + two competitor-migration skills (`cometchat-migrate-from-sendbird`, `cometchat-migrate-from-getstream`, installed for every platform), then a **full skill set per platform**. Every UI-Kit family ships `core` (install · credentials · init→login→render · the golden-path chat surface) plus, as the platform needs them, `components · placement · customization · features · calls · push · migration` and platform extras (`patterns`, `production`, `testing`, `troubleshooting`, `events`, the Android `compose-*` / `kotlin-*` cohorts):
| Family | UI Kit package | Consumption |
|---|---|---|
| **React v7** | `@cometchat/chat-uikit-react@7` | drop-in UI Kit (+ Vite / Next.js / React Router / Astro glue) |
| **Angular v5** | `@cometchat/chat-uikit-angular@5` | drop-in UI Kit |
| **React Native v5** | `@cometchat/chat-uikit-react-native@5` | drop-in UI Kit (bare + Expo) |
| **iOS v5** | `CometChatUIKitSwift` (SPM) | drop-in UI Kit (host-composed screens) |
| **Android v6** | `chatuikit-{compose,kotlin}-android` | drop-in UI Kit (Compose + Kotlin/View) |
| **Flutter v6** | `cometchat_chat_uikit ^6` | drop-in UI Kit |
| **Calls SDK v5** (headless) | JS · React Native · iOS · Android · Flutter | standalone voice/video, no UI Kit |
| **Chat SDK v5** (headless) | Android | headless messaging, no UI Kit |
## Compatibility
- **React v7** — `@cometchat/chat-uikit-react@7` (7.1.x) + `@cometchat/chat-sdk-javascript@4`; calls `@cometchat/calls-sdk-javascript@5`. React ≥ 18.
- **Angular v5** — `@cometchat/chat-uikit-angular@5` (5.1–5.2) + Chat SDK v4 + Calls SDK v5. Angular 17–21.
- **React Native v5** — `@cometchat/chat-uikit-react-native@5` + `@cometchat/chat-sdk-react-native@4` + `@cometchat/calls-sdk-react-native@5`.
- **iOS v5** — `CometChatUIKitSwift` 5.1.x + `CometChatSDK` 4.1.x + `CometChatCallsSDK` 5.0.x (Swift Package Manager).
- **Android v6** — `chatuikit-{compose,kotlin}-android` 6.0.x + `chat-sdk-android` 5.0.x + `calls-sdk-android` 5.0.x.
- **Flutter v6** — `cometchat_chat_uikit ^6` (6.1.x) + `cometchat_calls_sdk ^5` (calls).
Exact pinned versions per family live in `peers.yaml` and each family's `SKILL.md` frontmatter (both ship in the package).
## Links
- Docs: [cometchat.com/docs](https://www.cometchat.com/docs)
- UI Kits: [`@cometchat/chat-uikit-react`](https://www.npmjs.com/package/@cometchat/chat-uikit-react) · [`-angular`](https://www.npmjs.com/package/@cometchat/chat-uikit-angular) · [`-react-native`](https://www.npmjs.com/package/@cometchat/chat-uikit-react-native)
## License
MIT
© CometChat · MIT · hashgraph-online/awesome-codex-plugins