Agent skill

Cometchat React Native Push

by cometchat in cometchat/cometchat-skills

Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device.

MITAuto-check passedMobile

Install Cometchat React Native Push

skills CLI
$ npx skills add cometchat/cometchat-skills --skill cometchat-react-native-push -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cometchat/cometchat-skills cometchat-react-native-push --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cometchat/cometchat-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cometchat-react-native-push .claude/skills/cometchat-react-native-push && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cometchat-react-native-push
GitHub stars
129
Token cost
~1.3k tokens
SKILL.md length
563 words
Files
1
Skills in repo
97
Repo updated
First seen
Licence
MIT

At a glance

Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device.

  • Works in 3 steps: init() → login() must have completed. A… → Get the device token from your messaging… → Register it with CometChat
  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers Companion skills (read first), Use this skill when, Prerequisites & install and The wiring — three steps, in…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cometchat React Native Push is an agent skill from cometchat/cometchat-skills. Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device. Triggers: CometChat push notifications React Native, FCM CometChat RN, APNs chat notifications, notifications not arriving React Native, VoIP call push RN.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: React Native =0.77; @cometchat/chat-sdk-react-native ^4.0.28; @react-native-firebase/messaging

It sits in Mobile, covering Cross-platform mobile apps. It works with CometChat, React Native, Android and iOS. The repository describes itself as: Add CometChat chat & messaging and voice & video calls to any React, Next.js, React Native, Angular, Android, iOS, or Flutter project through your AI coding agent. Works with… The licence is MIT.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/cometchat-react-native-push”

Requirements

  • Compatibility (from SKILL.md): React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28; @react-native-firebase/messaging

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. init() → login() must have completed. A token registered before login belongs to nobody.
  2. Get the device token from your messaging library (typically @react-native-firebase/messaging).
  3. Register it with CometChat

What it can do on your machine

Read from SKILL.md and the folder at commit 911b108. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28; @react-native-firebase/messaging

    From compatibility in the SKILL.md frontmatter.

Context cost

Cometchat React Native Push loads about 1.3k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 563 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cometchat/cometchat-skills at commit 911b108, republished under its MIT licence (© cometchat). 563 words, ~1,304 tokens.

Download SKILL.mdSave it as .claude/skills/cometchat-react-native-push/SKILL.md (or your agent's skills folder).
name
cometchat-react-native-push
description
Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device. Triggers: CometChat push notifications React Native, FCM CometChat RN, APNs chat notifications, notifications not arriving React Native, VoIP call push RN.
compatibility
React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28; @react-native-firebase/messaging
license
MIT
metadata.author
CometChat
metadata.version
1.0.0
metadata.tags
chat cometchat react-native push notifications fcm apns voip token

Ground truth: @cometchat/chat-sdk-react-native@4 + catalog rn-sdk-v4.json + features.rn-v5.json → push-notifications. Docs: /notifications/react-native-push-notifications-android · …-ios. This skill is docs-first — fetch the current setup steps; do not bake a Firebase tutorial.

Companion skills (read first)

  • cometchat-react-native-core — install, provider chain, init→login→render. Assumed, not repeated here.

Use this skill when

  • "add push notifications" · "notifications aren't arriving" · "VoIP call push" · "register the FCM token"

Prerequisites & install

Push is not web push. There is no service worker. React Native uses the OS transports:

PlatformTransportNeeds
AndroidFCMgoogle-services.json in android/app/
iOSFCM (via Firebase → APNs)GoogleService-Info.plist, an APNs key uploaded to the dashboard, Push capability in Xcode

Enable Push Notifications in the CometChat dashboard first and add the provider for the right platform. With @react-native-firebase/messaging, both Android and iOS use the FCM provider — Firebase relays to APNs on iOS and hands your app an FCM token, so you register it with CometChat as an FCM platform (see below). A raw-APNs (APNS_REACT_NATIVE_*) provider is only for a hand-rolled PushKit / native-APNs setup that skips Firebase.

The wiring — three steps, in this order

  1. init() → login() must have completed. A token registered before login belongs to nobody.
  2. Get the device token from your messaging library (typically @react-native-firebase/messaging).
  3. Register it with CometChat:
CometChatNotifications.registerPushToken(token, CometChatNotifications.PushPlatforms.FCM_REACT_NATIVE_ANDROID, providerId)

Platform constants match the token you actually hold. Because the Firebase library above yields an FCM token on both platforms, use PushPlatforms.FCM_REACT_NATIVE_ANDROID on Android and PushPlatforms.FCM_REACT_NATIVE_IOS on iOS (verified in @cometchat/chat-sdk-react-native CometChat.d.ts). The APNS_REACT_NATIVE_DEVICE / APNS_REACT_NATIVE_VOIP constants are ONLY for a raw APNs device/VoIP token from a hand-rolled PushKit setup — do not use them with a Firebase FCM token. Fetch the exact argument order from the docs page for that platform. CometChatNotifications, registerPushToken, unregisterPushToken and PushPlatforms are all verified present in catalogs/rn-sdk-v4.json.

  1. Unregister on logout — unregisterPushToken(). Skipping this is why a shared or re-used device keeps delivering the previous user's notifications.

Token refresh is not optional

Device tokens rotate. Subscribe to your messaging library's token-refresh event and re-register, or push silently stops working days later for a subset of users — the hardest push bug to diagnose because nothing fails at the time.

Show full SKILL.md (220 more words)Show less

VoIP / call notifications

Calls need a data-only push plus a native dialer integration (CallKeep) so the device rings while the app is killed. That is a materially bigger build than message push, with its own iOS entitlements. Fetch /notifications/react-native-push-notifications-android and …-ios and follow them — do not improvise it.

Why this cannot be smoke-tested

Push requires a real device (or an emulator image with Play services for FCM), real credentials, and the app in background or killed. It cannot be verified headlessly, in CI, or on an iOS simulator. features.rn-v5.json marks it accordingly — treat a "works" claim without device evidence as unproven.

Common pitfalls

  1. Registering before login — the token is attached to no user.
  2. Not unregistering on logout — the next user gets the previous user's pushes.
  3. Ignoring token refresh — push dies quietly, later.
  4. Wrong platform constant — registration succeeds, delivery never happens.
  5. Missing google-services.json / GoogleService-Info.plist — build or registration failure.
  6. Testing on an iOS simulator — APNs does not work there.
  7. Expecting message-push setup to cover calls — VoIP needs data-only push + CallKeep.

Verify it works

  • Every emitted symbol is in catalogs/rn-sdk-v4.json.
  • Dashboard: push enabled, correct provider added for the platform.
  • On a real device: notification arrives with the app backgrounded and killed; tapping it opens the right conversation; after logout the device stops receiving that user's notifications.

© cometchat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cometchat-react-native-push of cometchat/cometchat-skills.

Open the folder on GitHubat commit 911b108

Compare with similar skills

Cometchat React Native Push next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cometchat React Native Push compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cometchat React Native Push this skillcometchat/cometchat-skills129—~1.3kAutomated safety check: PassMIT
Rnn Codebasewix/react-native-navigation13k—~2kAutomated safety check: PassMIT
Expo Tailwind SetupCherryHQ/cherry-studio-app4k8 repos~3kAutomated safety check: PassMIT
Screenmapaleqsio/screenmap239—~7.2kAutomated safety check: PassMIT
Expo Brownfield Integrationmweinbach/agent-coworker1562 repos~900Automated safety check: NotesCustom licence
Simulator Audio E2Ehyochan/react-native-nitro-sound961—~1.1kAutomated safety check: PassMIT

Similar skills

  • Rnn Codebase

    wix/react-native-navigation

    Official

    Navigate and work with the react-native-navigation (RNN) codebase.

    13k GitHub stars~2k tokensUpdated yesterday
    MobileAuto-check passed
  • Expo Tailwind Setup

    CherryHQ/cherry-studio-app

    Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling

    4k GitHub starsUsed in 8 repos~3k tokens
    MobileAuto-check passed
  • Screenmap

    aleqsio/screenmap

    Generate a visual navigation map of an Expo / React Native or NativeScript app.

    239 GitHub stars~7.2k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Expo Brownfield Integration

    mweinbach/agent-coworker

    Helps add Expo and React Native to an existing native iOS or Android app, and choose between a prebuilt AAR or XCFramework and a fully integrated build.

    156 GitHub starsUsed in 2 repos~900 tokens
    MobileAuto-check: notes
  • Simulator Audio E2E

    hyochan/react-native-nitro-sound

    Build and run repeatable react-native-nitro-sound recorder/player regression tests on an iOS Simulator or Android emulator, with explicit virtual-device selection, microphone permission, Maestro…

    961 GitHub stars~1.1k tokensUpdated 8 days ago
    MobileAuto-check passed
  • Agent Device

    gronxb/hot-updater

    Automates interactions for iOS simulators/devices and Android emulators/devices.

    1.8k GitHub stars~3.9k tokensUpdated today
    MobileAuto-check passed

More from cometchat/cometchat-skills

All 97 skills in this repo
  • CometChat Android Calls SDK v5

    cometchat/cometchat-skills

    Adds voice and video calling to an Android app in Kotlin with the headless CometChat Calls SDK v5, covering meeting-style rooms, 1:1 ringing calls, call logs and recording.

    129 GitHub stars~5.2k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Android v5 Headless SDK

    cometchat/cometchat-skills

    Builds chat on Android with your own UI against the headless CometChat Chat SDK v5, covering install, Jetifier conflicts, credentials and init-before-login ordering.

    129 GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Component Picker

    cometchat/cometchat-skills

    Picks and customizes CometChat's Angular UI Kit components by their verified component list, exact input and output event names, and the surfaces that have no kit component at all.

    129 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Features

    cometchat/cometchat-skills

    Enables or builds CometChat features such as polls, reactions, smart replies and pinned messages in an Angular app, first classifying how much client code each one needs.

    129 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • CometChat Angular Chat Placement

    cometchat/cometchat-skills

    Decides where CometChat chat UI goes in an Angular app: a dedicated route, a dashboard panel, a support widget or the full multi-pane app, with thread and search panels.

    129 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Cometchat iOS V5 SDK

    cometchat/cometchat-skills

    Add voice & video calling to any iOS app FROM SCRATCH with the headless CometChat Calls SDK v5 (CometChatCallsSDK, via Swift Package Manager) — no UI Kit.

    129 GitHub stars~5.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Cometchat React Native Push

What does Cometchat React Native Push do?

Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device. Cometchat React Native Push is an agent skill from cometchat/cometchat-skills. Push notifications for CometChat in React Native — FCM on Android, APNs on iOS, registering the device token with CometChatNotifications, and why none of it can be verified without a real device.

When should I use Cometchat React Native Push?

Cometchat React Native Push fits situations like: tasks that involve Cross-platform mobile apps.

How do I install Cometchat React Native Push in Claude Code?

Run `npx skills add cometchat/cometchat-skills --skill cometchat-react-native-push -a claude-code`. Or copy the skill folder (skills/cometchat-react-native-push in cometchat/cometchat-skills) into .claude/skills/cometchat-react-native-push in your project. Claude Code loads it when a task matches its description.

How do I install Cometchat React Native Push in Codex?

Run `npx skills add cometchat/cometchat-skills --skill cometchat-react-native-push -a codex`. Or copy the skill folder (skills/cometchat-react-native-push in cometchat/cometchat-skills) into .agents/skills/cometchat-react-native-push in your project. Codex loads it when a task matches its description.

Can I use Cometchat React Native Push in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cometchat/cometchat-skills --skill cometchat-react-native-push -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cometchat-react-native-push, .gemini/skills/cometchat-react-native-push, .github/skills/cometchat-react-native-push and .opencode/skills/cometchat-react-native-push in your project.

What does Cometchat React Native Push need to run?

SKILL.md names no scripts, command-line tools or credentials: Cometchat React Native Push is instructions for the agent only. Compatibility (from SKILL.md): React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28; @react-native-firebase/messaging.

Does Cometchat React Native Push access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cometchat React Native Push safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cometchat React Native Push use?

Cometchat React Native Push is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cometchat React Native Push use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cometchat React Native Push?

Skills that share tags, products or a category with Cometchat React Native Push: Rnn Codebase (wix/react-native-navigation, 13k stars), Expo Tailwind Setup (CherryHQ/cherry-studio-app, 4k stars), Screenmap (aleqsio/screenmap, 239 stars) and Expo Brownfield Integration (mweinbach/agent-coworker, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cometchat React Native Push?

cometchat (a GitHub organization) maintains it in cometchat/cometchat-skills, which has 129 GitHub stars. The repository holds 97 skills in this directory. The repository was last updated on October 5, 2026.

Source: cometchat/cometchat-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.