Agent skill

Cometchat Flutter V6 Troubleshooting

by cometchat in cometchat/cometchat-skills

Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5…

MITAuto-check passedMobile

Install Cometchat Flutter V6 Troubleshooting

skills CLI
$ npx skills add cometchat/cometchat-skills --skill cometchat-flutter-v6-troubleshooting -a claude-code

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

GitHub CLI
$ gh skill install cometchat/cometchat-skills cometchat-flutter-v6-troubleshooting --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-flutter-v6-troubleshooting .claude/skills/cometchat-flutter-v6-troubleshooting && 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-flutter-v6-troubleshooting
GitHub stars
130
Token cost
~1.6k tokens
SKILL.md length
766 words
Files
1
Skills in repo
97
Repo updated
First seen
Licence
MIT

At a glance

Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5…

  • Works in 5 steps: Does flutter analyze pass? A stale v5… → Did init AND login both reach onSuccess?… → Is the failing widget inside a bounded… → …
  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers Companion skills (read first), Use this skill when, Prerequisites & install and Triage in order (cheapest first), plus 4 more sections
  • Calls flutter

What it does

Cometchat Flutter V6 Troubleshooting is an agent skill from cometchat/cometchat-skills. Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5 leftovers. Symptom → cause → fix. Triggers: 'cometchat not working flutter', 'blank chat screen', 'RenderFlex unbounded height', 'login failed cometchat', 'calls not ringing', 'push not arriving'.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Flutter =3.38.9; cometchatchatuikit ^6 (6.1.x, verified 6.1.0); cometchatsdk ^5.0.6

It sits in Mobile, covering Cross-platform mobile apps. It works with CometChat and Flutter. 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 not working flutter”
  • “blank chat screen”
  • “RenderFlex unbounded height”
  • “/cometchat-flutter-v6-troubleshooting”

Requirements

  • Compatibility (from SKILL.md): Flutter >=3.38.9; cometchat_chat_uikit ^6 (6.1.x, verified 6.1.0); cometchat_sdk ^5.0.6

Workflow steps

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

  1. Does flutter analyze pass? A stale v5 symbol or a wrong barrel import is a compile error, not a runtime mystery.
  2. Did init AND login both reach onSuccess? Log both. Most "blank chat" reports stop here.
  3. Is the failing widget inside a bounded box? The second-most-common cause, and it is always the host's container.
  4. Is the thing you expect actually enabled — Dashboard toggle (extensions, moderation), uiKit.enableCalling, a push provider?
  5. Only then look at the kit.

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

    Shell commands in SKILL.md call:

    • flutter

    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

    Flutter >=3.38.9; cometchat_chat_uikit ^6 (6.1.x, verified 6.1.0); cometchat_sdk ^5.0.6

    From compatibility in the SKILL.md frontmatter.

Context cost

Cometchat Flutter V6 Troubleshooting loads about 1.6k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 766 words of instructions outside code blocks.

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

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). 766 words, ~1,625 tokens.

Download SKILL.mdSave it as .claude/skills/cometchat-flutter-v6-troubleshooting/SKILL.md (or your agent's skills folder).
name
cometchat-flutter-v6-troubleshooting
description
Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5 leftovers. Symptom → cause → fix. Triggers: 'cometchat not working flutter', 'blank chat screen', 'RenderFlex unbounded height', 'login failed cometchat', 'calls not ringing', 'push not arriving'.
compatibility
Flutter >=3.38.9; cometchat_chat_uikit ^6 (6.1.x, verified 6.1.0); cometchat_sdk ^5.0.6
license
MIT
metadata.author
CometChat
metadata.version
1.0.0
metadata.tags
cometchat flutter troubleshooting diagnostics errors symptoms v6

Ground truth: every cause below was confirmed against the published 6.1.0 (compiler or documented behaviour). The live page is /ui-kit/flutter/troubleshooting via ../cometchat-flutter-v6-core/references/docs-map.md. The deeper per-topic tables live in core's references/troubleshooting.md and references/anti-patterns.md — this skill is the entry point that ROUTES to the right one.

Companion skills (read first)

  • cometchat-flutter-v6-core — install, credentials, init→login→render, plus the reference tables this skill routes into. This skill ASSUMES it.

Use this skill when

Something is already built and is not working: a blank screen, a crash, an empty list, no ring, no notification.

Prerequisites & install

None — diagnosis only.

Triage in order (cheapest first)

  1. Does flutter analyze pass? A stale v5 symbol or a wrong barrel import is a compile error, not a runtime mystery.
  2. Did init AND login both reach onSuccess? Log both. Most "blank chat" reports stop here.
  3. Is the failing widget inside a bounded box? The second-most-common cause, and it is always the host's container.
  4. Is the thing you expect actually enabled — Dashboard toggle (extensions, moderation), uiKit.enableCalling, a push provider?
  5. Only then look at the kit.

Symptom → cause → fix

SymptomCauseFix
Blank/white chat screenA widget built before login resolvedGate the first frame on init and login (lifecycle.md)
Unable to load asset: cometchat-settings.jsonNot at project root, or not registeredAdd under flutter: assets:, re-run flutter pub get
Crash on startup before any UIWidgetsFlutterBinding.ensureInitialized() missingCall it first in main() — initFromSettings reads an asset
RenderFlex … unbounded heightA kit list in an unbounded parentExpanded/Flexible, or a fixed height (layout.md)
List renders as a zero-height sliverSame — content-driven parentSame
Composer hidden by the keyboardresizeToAvoidBottomInset: false, or nested ScaffoldsLeave the default true; one Scaffold per screen
Header under the notchNo SafeAreaWrap the body
Two app barsYour Scaffold AppBar + the widget's ownhideAppbar: true on the list widget
Login fails instantlyWrong Region, or the UID doesn't existMatch the Dashboard region exactly; use a real UID (Dashboard → Users)
Works in debug, fails in releaseObfuscation, or the settings asset not bundledTest the release build; verify the asset ships
Undefined name 'CometChatIncomingCall' (any call widget)Only the chat barrel importedAlso import …/cometchat_calls_uikit.dart (-calls)
Call buttons never appearCalls not enabled on BOTH sidesuiKit.enableCalling: true and cometchat_calls_sdk installed
Call surface opens blackCamera/mic permission missing, or a simulatorAdd usage strings/permissions; test on a real device
Incoming call never shows (calling on)No navigatorKey on the root MaterialApp — kit logs "Incoming call overlay cannot be shown"navigatorKey: CallNavigationContext.navigatorKey (-calls)
Two incoming-call screensOwn CallListener + CometChatIncomingCall on top of the kit's CallEventService overlayRemove yours — the kit presents it; customize via CallingConfiguration
Thread replies never sendparentMessageId without user:/group:Pass BOTH on the thread list and composer
Enabled extension doesn't appearExpecting v5 registrationv6 auto-surfaces it; confirm the Dashboard toggle, add NO code
Push never arrivesNo Dashboard provider, or registered before loginConfigure the provider; register after login; re-register on refresh (-push)
Previous user still gets notificationsPush token never unregistered on logoutUnregister before logout()
Presence never updatessubscribePresenceForAllUsers falseSet it true in the settings file
Messages only arrive on reopenSocket not auto-connectingchatSDK.autoEstablishSocketConnection: true
Duplicate events after hot restartListener not removed in disposePair every add with a remove (-events)
The named parameter 'x' isn't defined on a kit widgetFollowing a doc page that driftedTrust the compiler; several Flutter pages had wrong signatures — check DOCS-BACKLOG.md PART 4
Android build fails on minSdkBelow the floor (the docs' 24 is too low)minSdk = 26 — forced by cometchat_calls_sdk, a hard dependency of the kit
iOS pod install failsDeployment target too lowplatform :ios, '15.1' (13.0 through calls-sdk 5.0.6), then pod install
Everything broke after upgradingMixed majors / removed v5 APIs→ cometchat-flutter-v6-migration; never mix majors
Show full SKILL.md (134 more words)Show less

When the docs and the compiler disagree, the compiler wins

Several ui-kit/flutter pages documented parameters that do not exist in 6.1.0 (thread header, search callbacks, style names). If a documented snippet will not compile, that is a docs bug: use the real signature, and flag the page (RULES.md §20) rather than working around it forever.

Still stuck — collect this before escalating

Kit + SDK versions from pubspec.lock · the flutter analyze output · whether init/login reached onSuccess · the exact exception + stack · platform and whether it is a real device · the relevant Dashboard toggles. Most escalations are resolved by the first three.

Verify it works

The specific symptom is gone, flutter analyze is clean, and the fix was to the HOST's wiring (gating, container, imports, config) — if the answer looked like "patch around the kit", re-check the table.

© 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-flutter-v6-troubleshooting of cometchat/cometchat-skills.

Open the folder on GitHubat commit 911b108

Compare with similar skills

Cometchat Flutter V6 Troubleshooting 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 Flutter V6 Troubleshooting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cometchat Flutter V6 Troubleshooting this skillcometchat/cometchat-skills130—~1.6kAutomated safety check: PassMIT
Add Flutter Docusaurus Localematthiasn/lotti1.2k—~1.2kAutomated safety check: PassGPL-3.0
Tm Launcher DesignFar-Se/tabame372—~3.1kAutomated safety check: PassMIT
Mobile App UI Designceorkm/mobile-app-ui-design400—~2kAutomated safety check: PassNone
Marionette Flutter Drive Appleancodepl/marionette_mcp473—~11kAutomated safety check: PassApache-2.0
Flutter ScreenshotJustLookAtNow/pt_mate503—~511Automated safety check: PassMIT

Similar skills

  • Add, complete, or audit a locale across a Flutter application's ARB catalogs and a localized Docusaurus manual, including generated localization code, locale selectors, native platform declarations…

    1.2k GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed
  • Tm Launcher Design

    Far-Se/tabame

    Create or revise Tabame's Flutter launcher designs: frames, search bars, result rows, palettes, typography, and action dialogs.

    372 GitHub stars~3.1k tokensUpdated today
    MobileAuto-check passed
  • Mobile App UI Design

    ceorkm/mobile-app-ui-design

    Design high-quality mobile app UI/UX screens, flows, and components.

    400 GitHub stars~2k tokensUpdated 3 mo ago
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    473 GitHub stars~11k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Flutter Screenshot

    JustLookAtNow/pt_mate

    Capture and show two Flutter UI screenshots for this project: one landscape/large-screen preview and one portrait/mobile preview, without using Flutter Web.

    503 GitHub stars~511 tokensUpdated 3 days ago
    MobileAuto-check passed
  • Flutter Init

    bear2u/my-skills

    A skill your agent uses when user wants to create a new Flutter project (Todo/Habit/Note/Expense/Custom domain) with Clean Architecture, Riverpod 3.0, Drift, and modern Flutter stack

    933 GitHub stars~2.5k tokensUpdated 3 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.

    130 GitHub stars~5.2k tokensUpdated 3 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.

    130 GitHub stars~4k tokensUpdated 3 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.

    130 GitHub stars~2.6k tokensUpdated 3 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.

    130 GitHub stars~2.6k tokensUpdated 3 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.

    130 GitHub stars~2.2k tokensUpdated 3 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.

    130 GitHub stars~5.2k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Cometchat Flutter V6 Troubleshooting

What does Cometchat Flutter V6 Troubleshooting do?

Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5…. Cometchat Flutter V6 Troubleshooting is an agent skill from cometchat/cometchat-skills. Diagnose a broken CometChat Flutter integration — blank screens, unbounded-height crashes, lists that don't fill, login and Region failures, calls that never ring, push that never arrives, and v5 leftovers.

When should I use Cometchat Flutter V6 Troubleshooting?

Cometchat Flutter V6 Troubleshooting fits situations like: tasks that involve Cross-platform mobile apps.

How do I install Cometchat Flutter V6 Troubleshooting in Claude Code?

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

How do I install Cometchat Flutter V6 Troubleshooting in Codex?

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

Can I use Cometchat Flutter V6 Troubleshooting 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-flutter-v6-troubleshooting -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-flutter-v6-troubleshooting, .gemini/skills/cometchat-flutter-v6-troubleshooting, .github/skills/cometchat-flutter-v6-troubleshooting and .opencode/skills/cometchat-flutter-v6-troubleshooting in your project.

What does Cometchat Flutter V6 Troubleshooting need to run?

Going by SKILL.md and its folder, Cometchat Flutter V6 Troubleshooting needs the command-line tools its instructions call (flutter). Compatibility (from SKILL.md): Flutter >=3.38.9; cometchat_chat_uikit ^6 (6.1.x, verified 6.1.0); cometchat_sdk ^5.0.6.

Does Cometchat Flutter V6 Troubleshooting 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 Flutter V6 Troubleshooting 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 Flutter V6 Troubleshooting use?

Cometchat Flutter V6 Troubleshooting 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 Flutter V6 Troubleshooting use?

About 1.6k tokens (SKILL.md is roughly 6.5k 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 Flutter V6 Troubleshooting?

Skills that share tags, products or a category with Cometchat Flutter V6 Troubleshooting: Add Flutter Docusaurus Locale (matthiasn/lotti, 1.2k stars), Tm Launcher Design (Far-Se/tabame, 372 stars), Mobile App UI Design (ceorkm/mobile-app-ui-design, 400 stars) and Marionette Flutter Drive App (leancodepl/marionette_mcp, 473 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cometchat Flutter V6 Troubleshooting?

cometchat (a GitHub organization) maintains it in cometchat/cometchat-skills, which has 130 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.