Agent skill

Cometchat iOS Push

by cometchat in cometchat/cometchat-skills

Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes.

MITAuto-check passedMobile

Install Cometchat iOS Push

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

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

GitHub CLI
$ gh skill install cometchat/cometchat-skills cometchat-ios-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-ios-push .claude/skills/cometchat-ios-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-ios-push
GitHub stars
129
Token cost
~1k tokens
SKILL.md length
487 words
Files
1
Skills in repo
97
Repo updated
First seen
Licence
MIT

At a glance

Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes.

  • Works in 4 steps: Request authorisation and register for… → After CometChat.init, call… → Handle the tap: read the payload,… → …
  • Mobile work in your project
  • SKILL.md covers Companion skills (read first), Use this skill when, What you must have before any… and The shape of the integration —…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cometchat iOS Push is an agent skill from cometchat/cometchat-skills. Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes. Triggers: 'push notifications cometchat ios', 'apns cometchat', 'open chat from notification ios', 'voip push call ios'.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: CometChatUIKitSwift 5.1.22 · CometChatSDK 4.1.7 · iOS 15.1+

It sits in Mobile. It works with CometChat 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

  • Mobile work in your project

Example prompts

  • “push notifications cometchat ios”
  • “apns cometchat”
  • “open chat from notification ios”
  • “/cometchat-ios-push”

Requirements

  • Compatibility (from SKILL.md): CometChatUIKitSwift 5.1.22 · CometChatSDK 4.1.7 · iOS 15.1+

Workflow steps

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

  1. Request authorisation and register for remote notifications (on a real device — the simulator does not receive APNs).
  2. After CometChat.init, call CometChatPushNotifications.shared.initialize(config:) and set its .delegate. In…
  3. Handle the tap: read the payload, resolve the conversation, and push your chat screen — the same screen core builds. A notification that…
  4. Log out unregisters. Leaving a stale token delivers a user's messages to a device someone else may now be using — treat it as a…

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

    CometChatUIKitSwift 5.1.22 · CometChatSDK 4.1.7 · iOS 15.1+

    From compatibility in the SKILL.md frontmatter.

Context cost

Cometchat iOS Push loads about 1k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 487 words of instructions outside code blocks.

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

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). 487 words, ~1,017 tokens.

Download SKILL.mdSave it as .claude/skills/cometchat-ios-push/SKILL.md (or your agent's skills folder).
name
cometchat-ios-push
description
Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes. Triggers: 'push notifications cometchat ios', 'apns cometchat', 'open chat from notification ios', 'voip push call ios'.
compatibility
CometChatUIKitSwift 5.1.22 · CometChatSDK 4.1.7 · iOS 15.1+
license
MIT
metadata.author
CometChat
metadata.version
1.0.0
metadata.tags
cometchat ios push apns voip pushkit notifications swift v5

Companion skills (read first)

  • cometchat-ios-core owns setup and login. This skill ADDS delivery. It is docs-first and thin: push depends on your Apple account, certificates and Dashboard configuration, so fetch the notifications docs via cometchat-ios-core/references/docs-map.md rather than trusting a baked recipe.

Use this skill when

"add push notifications", "open the right chat when a notification is tapped", "ring on an incoming call while backgrounded".

What you must have before any code

Push is not a code-only feature. All of these are prerequisites and none are things a skill can do for the user: an Apple Developer account with the Push Notifications capability, an APNs key or certificate uploaded to the CometChat Dashboard, and the Notifications product enabled for the app. If any are missing, say so plainly and stop — do not emit code that cannot work.

The shape of the integration — use CometChatPushNotifications, do NOT hand-roll

The current, canonical iOS path is the CometChatPushNotifications SDK (module CometChatPushNotificationsSwift), the same one cometchat-ios-v5-sdk documents. Do not hand-roll UIKitSettings.set(deviceToken:) / set(voipToken:), PKPushRegistryDelegate or CXProviderDelegate — those setters exist but are the legacy path the sample app and current docs no longer use.

  1. Request authorisation and register for remote notifications (on a real device — the simulator does not receive APNs).
  2. After CometChat.init, call CometChatPushNotifications.shared.initialize(config:) and set its .delegate. In didRegisterForRemoteNotificationsWithDeviceToken, forward the APNs token with CometChatPushNotifications.shared.registerDeviceToken(_:). Ordering is not your problem — the token can arrive before login; the SDK caches it and binds it to the user automatically once you initialize and the user logs in. (There is no need to gate didRegister… on login, and no set(deviceToken:) call.)
  3. Handle the tap: read the payload, resolve the conversation, and push your chat screen — the same screen core builds. A notification that opens the app to the wrong place is the push equivalent of a dead-end affordance.
  4. Log out unregisters. Leaving a stale token delivers a user's messages to a device someone else may now be using — treat it as a correctness and privacy requirement, not a nicety.
Show full SKILL.md (152 more words)Show less

VoIP / calls

Ringing while backgrounded is also CometChatPushNotifications, not a hand-rolled channel: it owns PushKit + CallKit for you (registerForVoIPPushes(), presentCallScreen(for:sessionId:)). Never write your own PKPushRegistryDelegate / CXProviderDelegate or call UIKitSettings.set(voipToken:) — the SDK owns both and a hand-rolled one fights it for the same callbacks. Full VoIP wiring lives in cometchat-ios-v5-sdk (§ "VoIP call notifications"); it needs an APNs VoIP provider in the Dashboard, the Voice-over-IP Background Mode, and a physical device.

Gotchas

  • Simulator cannot verify this. Delivery must be checked on a physical device; expect the automated gate to report push as blocked-external.
  • Badge counts drift unless you update and clear them deliberately.
  • Sandbox vs production APNs are different environments — a token from one will not deliver on the other.

Verify it works

On a real device: background the app, send a message from another user, see the notification, tap it and land in the right conversation. Then log out and confirm notifications stop.

© 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-ios-push of cometchat/cometchat-skills.

Open the folder on GitHubat commit 911b108

Compare with similar skills

Cometchat iOS 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 iOS Push compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cometchat iOS Push this skillcometchat/cometchat-skills129—~1kAutomated safety check: PassMIT
Hig Project Contextraintree-technology/hig-doctor1425 repos~1.2kAutomated safety check: PassMIT
Hig Components Contentraintree-technology/hig-doctor1425 repos~1.3kAutomated safety check: PassMIT
Discover iOS KeysPoomSmart/MGKeys237—~1.4kAutomated safety check: PassMIT
Argent Metro Debuggerbbplayer-app/BBPlayer1.1k—~3.4kAutomated safety check: PassMIT
iOS Simulator Skilln0an/VivaDicta1261 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    142 GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    142 GitHub starsUsed in 5 repos~1.3k tokens
    MobileAuto-check passed
  • Discover iOS Keys

    PoomSmart/MGKeys

    Discover and map new MobileGestalt keys for a new iOS version in MGKeys.

    237 GitHub stars~1.4k tokensUpdated 19 days ago
    MobileAuto-check passed
  • Argent Metro Debugger

    bbplayer-app/BBPlayer

    Debug a JS runtime via CDP using argent debugger tools. An agent skill from bbplayer-app/BBPlayer.

    1.1k GitHub stars~3.4k tokensUpdated yesterday
    MobileAuto-check passed
  • iOS Simulator Skill

    n0an/VivaDicta

    21 production-ready scripts for iOS app testing, building, and automation.

    126 GitHub starsUsed in 1 repo~2.5k tokens
    MobileAuto-check passed
  • Theming

    Code-with-Beto/skills

    Scaffold a unified, cross-platform color theme system into an Expo Router app.

    141 GitHub stars~2.5k tokensUpdated 2 mo ago
    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

Works with

Categories

Questions about Cometchat iOS Push

What does Cometchat iOS Push do?

Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes. Cometchat iOS Push is an agent skill from cometchat/cometchat-skills. Add push notifications to an iOS CometChat app — APNs registration, token handoff, tap-to-open, badge counts and VoIP call pushes.

When should I use Cometchat iOS Push?

Cometchat iOS Push fits situations like: mobile work in your project.

How do I install Cometchat iOS Push in Claude Code?

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

How do I install Cometchat iOS Push in Codex?

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

Can I use Cometchat iOS 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-ios-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-ios-push, .gemini/skills/cometchat-ios-push, .github/skills/cometchat-ios-push and .opencode/skills/cometchat-ios-push in your project.

What does Cometchat iOS Push need to run?

SKILL.md names no scripts, command-line tools or credentials: Cometchat iOS Push is instructions for the agent only. Compatibility (from SKILL.md): CometChatUIKitSwift 5.1.22 · CometChatSDK 4.1.7 · iOS 15.1+.

Does Cometchat iOS 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 iOS 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 iOS Push use?

Cometchat iOS 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 iOS Push use?

About 1k tokens (SKILL.md is roughly 4.1k 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 iOS Push?

Skills that share tags, products or a category with Cometchat iOS Push: Hig Project Context (raintree-technology/hig-doctor, 142 stars), Hig Components Content (raintree-technology/hig-doctor, 142 stars), Discover iOS Keys (PoomSmart/MGKeys, 237 stars) and Argent Metro Debugger (bbplayer-app/BBPlayer, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cometchat iOS 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.