cometchat-troubleshooting

Diagnose CometChat integration failures using cometchat doctor verify outputs.

Updated May 28, 2026
One-click install
npx skills add https://github.com/MAX5271/CometChat --skill cometchat-troubleshooting-max5271
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cometchat-troubleshooting
Source: https://github.com/MAX5271/CometChat/tree/main/.claude/skills/cometchat-troubleshooting
Command: npx skills add https://github.com/MAX5271/CometChat --skill cometchat-troubleshooting-max5271

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly diagnose and fix broken or drifted CometChat integrations by separating local integration issues from environment, dashboard, and network causes.

Core Features & Use Cases

  • Systematic triage: Reads integration state and runs verify checks to pinpoint failures like missing env vars, CSS import issues, init/login ordering problems, or missing error UI.
  • Drift awareness: Detects modified or missing owned integration files and guides you on whether changes were intentional before recommending restore.
  • Docs-backed symptom lookup: Uses the CometChat docs MCP for symptom-to-cause mappings when verify results don’t fully explain the issue.

Quick Start

Run the skill by asking: "Troubleshoot my CometChat integration issue and give me the targeted fix."

Frequently Asked Questions about cometchat-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my CometChat integration showing a blank chat screen?

A blank CometChat chat screen often stems from missing environment variables, CSS import issues, or incorrect init and login ordering. Run `cometchat doctor` verify checks to pinpoint the exact failure and apply targeted file-level fixes.

How do I fix 401 Unauthorized errors in CometChat?

Fix CometChat 401 Unauthorized errors by verifying local integration state and environment correctness. Use `cometchat doctor` to read verify outputs and confirm API keys and region settings are properly loaded before login.

What causes CometChat CSS variables not to load in the UI kit?

CometChat UI kit CSS variables fail to load when there are CSS import issues or drifted file structures. Diagnose this by running verify checks to inspect the integration state and reviewing modified owned files.

How do I troubleshoot missing messages in my CometChat integration?

Troubleshoot missing CometChat messages by checking init and login ordering problems alongside environment correctness. Use the cometchat-docs MCP for symptom-to-cause lookups when verify results do not fully explain the issue.

How do I detect configuration drift after customizing CometChat files?

Detect CometChat configuration drift by running `cometchat doctor` to identify modified or missing owned integration files. It guides you on whether changes were intentional before recommending a restore and post-fix verify loop.

Can I diagnose CometChat integration failures without network access?

Yes, you can diagnose local CometChat integration failures by verifying code structure, environment variables, and file drift offline. However, resolving dashboard or network causes and using the cometchat-docs MCP lookup requires connectivity.