Name: cometchat-android-v5
Author: cometchat

About

Imported from cometchat/cometchat-skills (skills/cometchat-android-v5/SKILL.md). Install upstream with npx skills add cometchat/cometchat-skills --skill cometchat-android-v5. Copyright stays with the author (MIT).

Ground truth: com.cometchat:chat-uikit-android:5.x (legacy/maintenance-only; +calls-sdk-android:5.x) — resolved AAR (javap) + ui-kit/android. Official docs: https://www.cometchat.com/docs/ui-kit/android/overview · Docs MCP: claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp (or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.

Purpose

This is the entry-point skill for CometChat Android UI Kit v5. It helps you understand what the developer is building, detects their project setup, and routes to the correct sub-skill for the task at hand.

All skills are designed to work with both Java and Kotlin projects. Code examples in each skill are provided in both languages.

Use this skill when

A developer asks to "add chat to my Android app"
Starting a new CometChat integration
Unsure which skill to use for a specific task
Need an overview of what CometChat Android UI Kit v5 offers

Do not use this skill when

You already know which specific skill is needed (go directly to it)

1. Project detection

Before writing any code, detect the project setup:

Check	How	Why
Language	Look for `.kt` files in `src/main/java/` or `src/main/kotlin/`	Determines Java vs Kotlin code examples
Gradle version	Check `gradle-wrapper.properties` for `distributionUrl`	Affects dependency syntax (Groovy vs Kotlin DSL)
Min SDK	Check `build.gradle` for `minSdkVersion`	Must be 24+ for CometChat
Existing CometChat	Search for `com.cometchat` in `build.gradle`	Avoid duplicate setup
Calling SDK	Search for `com.cometchat:calls-sdk-android`	Determines if voice/video is already available

2. What are you building?

Ask the developer what they're building to recommend the right placement:

Intent	Recommended placement	Components
Messaging app	Dedicated Activity with bottom tabs	`CometChatConversations` + `CometChatMessageList` + `CometChatMessageComposer` + `CometChatMessageHeader`
Marketplace / platform	Chat button on product screen + inbox Activity	Single thread (button trigger) + multi-conversation (inbox)
SaaS / dashboard	Chat Fragment in existing Activity	`CometChatConversations` in a Fragment
Social / community	Full messenger with tabs	Conversations + Users + Groups + Calls in ViewPager/BottomNav
Support / helpdesk	BottomSheet or Dialog overlay	`CometChatMessageList` + `CometChatMessageComposer` in BottomSheet
Just exploring	Minimal single-Activity demo	`CometChatConversations` with pre-logged-in test user

3. Skill routing reference

Skill	When to load
`cometchat-android-v5-core`	Always — before any integration code. Init, login, builder, dependencies.
`cometchat-android-v5-components`	Always — before writing component code. Full catalog of all CometChat views.
`cometchat-android-v5-placement`	When integrating — Activity, Fragment, BottomSheet, Dialog, Tab patterns.
`cometchat-android-v5-theming`	When customizing look and feel — colors, fonts, dark mode, style classes.
`cometchat-android-v5-features`	When adding features — calls, reactions, polls, AI, extensions.
`cometchat-android-v5-customization`	When writing custom templates, events, DataSource decorators.
`cometchat-android-v5-production`	When setting up production auth or user management.
`cometchat-android-v5-troubleshooting`	When diagnosing problems — Gradle errors, crashes, rendering issues.
`cometchat-android-v5-extensions`	When working with extensions (polls, stickers, collaborative, etc.).
`cometchat-android-v5-push`	When setting up push notifications (FCM, token lifecycle, deep-link).
`cometchat-android-v5-testing`	When adding tests (unit, UI, instrumented, E2E, CI).

4. Integration order

Every integration follows this sequence:

1. Dependencies (Gradle)          → cometchat-android-v5-core §1
2. Manifest permissions            → cometchat-android-v5-core §5
3. App theme setup                 → cometchat-android-v5-core §5b (must inherit CometChatTheme.DayNight — Material 2 parent)
4. Init + Login                    → cometchat-android-v5-core §2-3
5. Place components in your app    → cometchat-android-v5-placement
6. Customize appearance            → cometchat-android-v5-theming
7. Add features                    → cometchat-android-v5-features
8. Production hardening            → cometchat-android-v5-production

5. Iteration menu

After the initial integration, the developer can:

Customize look and feel — Theme presets, brand colors, dark mode
Add a feature — Calls, reactions, polls, AI smart replies, file sharing
Customize a component — Custom message bubbles, headers, composer actions
Set up production auth — Replace dev Auth Key with server-side tokens
Set up push notifications — FCM setup, token lifecycle, deep-link on tap
Add tests — Unit tests, UI tests, E2E with Maestro
Troubleshoot an issue — Gradle errors, runtime crashes, rendering problems

Route each choice to the appropriate skill.

Hard rules

Always read cometchat-android-v5-core first. It covers init, login, and dependencies — prerequisites for everything else.
Always read cometchat-android-v5-components before writing component code. Never invent component names or method signatures from memory.
Provide both Java and Kotlin examples. The v5 UIKit is written in Java but is fully interoperable with Kotlin. Client devs use both.
Ask, don't assume. Every integration decision (placement, features, auth mode) should be confirmed with the developer.
Always read existing files before modifying them. Never blindly overwrite project files.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/cometchat-cometchat-skills-cometchat-android-v5/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

cometchat-cometchat-skills-cometchat-android-v5.ocm.jsonjson

{
  "ocm": "1",
  "id": "cometchat-cometchat-skills-cometchat-android-v5",
  "kind": "skill",
  "name": "cometchat-android-v5",
  "description": "Entry-point dispatcher for CometChat Android UI Kit v5. Detects project setup, understands what the dev is building, and routes to the right sub-skills.",
  "publisher": "cometchat",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "chat",
      "cometchat",
      "android",
      "dispatcher",
      "entry-point",
      "integration",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Entry-point dispatcher for CometChat Android UI Kit v5. Detects project setup, understands what the dev is building, and routes to the right sub-skills."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/cometchat/cometchat-skills",
      "path": "skills/cometchat-android-v5/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/cometchat/cometchat-skills/blob/HEAD/skills/cometchat-android-v5/SKILL.md",
      "key": "cometchat/cometchat-skills/skills/cometchat-android-v5/SKILL.md"
    },
    "compatibility": "Android 7.0+; Java 8+; Kotlin 1.8+; com.cometchat:chat-uikit-android:5.x",
    "license": "MIT"
  },
  "instructions": "> **Ground truth:** `com.cometchat:chat-uikit-android:5.x` (legacy/maintenance-only; +`calls-sdk-android:5.x`) — resolved AAR (javap) + `ui-kit/android`. **Official docs:** https://www.cometchat.com/docs/ui-kit/android/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.\n\n## Purpose\n\nThis is the entry-point skill for CometChat Android UI Kit v5. It helps you understand what the developer is building, detects their project s",
  "cost": {
    "context_tokens": 1483
  }
}

Fetch it by URL: GET /api/v1/registry/cometchat-cometchat-skills-cometchat-android-v5/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.