[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MFMBTEK6RXAHDFZN31H0VS":3,"skill-same:01M6MFMBTEK6RXAHDFZN31H0VS":79},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":60,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M6MFMBTEK6RXAHDFZN31H0VS","cometchat-react-v7-troubleshooting",null,"Diagnose a broken CometChat React v7 integration — blank panes, a collapsed\u002F0-height surface, empty lists, no messages, the kit's error state, events that never fire, or a version_conflict. Triggers: 'cometchat react not working', 'chat is blank', 'conversations empty', 'messages not showing react', 'something went wrong cometchat', 'cometchat react errors', 'why is my chat broken'.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-v7-troubleshooting\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"cometchat","cometchat react v7 troubleshooting","troubleshooting","react","conflict","verified","my","conversations","kit","errors","error","events","screen","next","never","router","broken","why","astro","messages","diagnostics","2026-11-10 10:12:30",false,"---\nname: cometchat-react-v7-troubleshooting\ndescription: \"Diagnose a broken CometChat React v7 integration — blank panes, a collapsed\u002F0-height surface, empty lists, no messages, the kit's error state, events that never fire, or a version_conflict. Triggers: 'cometchat react not working', 'chat is blank', 'conversations empty', 'messages not showing react', 'something went wrong cometchat', 'cometchat react errors', 'why is my chat broken'.\"\nlicense: \"MIT\"\ncompatibility: \"@cometchat\u002Fchat-uikit-react ^7 (7.1.x–7.2.x verified); React 18–19; Vite \u002F Next.js \u002F CRA \u002F React Router \u002F Astro\"\nmetadata:\n  author: \"CometChat\"\n  version: \"1.0.0\"\n  tags: \"cometchat react v7 troubleshooting debug diagnostics blank-screen version-conflict\"\n---\n\n> **Ground truth:** `@cometchat\u002Fchat-uikit-react@7`. Symbols\u002Fsignatures are verified against `cometchat-react-v7-core` + its catalog and FETCHED via `references\u002Fdocs-map.md`; the rules referenced (init order, layout sizing, credentials) are `RULES.md`. This diagnostics catalog is cross-checked against the live `{DOCS_BASE}\u002Fui-kit\u002Freact\u002Ftroubleshooting.md` page (base + paths in `cometchat-react-v7-core\u002Freferences\u002Fdocs-map.md`), and adds the host-side\u002Fruntime symptoms it doesn't cover.\n\n## Companion skills (read first)\n- `cometchat-react-v7-core` — the correct init→login→render order, credentials, and the reflow-free layout the fixes below restore.\n\n## Use this skill when\nA React CometChat integration compiles but misbehaves at runtime: blank, empty, unresponsive, or throwing.\n\n## Start here — React fails on the ORDER and the BOX\nTwo causes explain most \"it's blank\":\n1. **A kit component rendered before `init()` + `login()` resolved.** The surface must be gated on the resolved logged-in user. Rendering it eagerly (or during SSR) yields an empty\u002Ferroring pane.\n2. **The container has no height.** The kit fills its parent; a parent at `height:auto`\u002F`0` collapses it to a sliver. This is a host CSS defect, not a kit bug (`RULES.md` → Layout \u002F sizing).\n\n## Symptom → cause → fix\n| Symptom | Likely cause | Fix |\n| --- | --- | --- |\n| Blank\u002Fwhite, no errors | Surface rendered before init+login resolved | Gate render on the resolved user; keep `CometChatErrorBoundary` for a visible fallback |\n| Blank during SSR \u002F `window is not defined` | A kit component imported or rendered on the server (Next.js, Astro, Remix) | Render the surface client-only — `\"use client\"` + `dynamic(..., { ssr:false })` (Next), `client:only` (Astro); see core `references\u002Fssr.md` |\n| Surface ~0px \u002F cramped top-left | Ancestor chain has no height | `html,body,#root{height:100%}` + a pinned surface (`100dvh` full-app) + panes `min-height:0`; see core `references\u002Flayout.md` |\n| \"OOPS! Looks like something went wrong\" | The kit's error state — a call threw (often a custom `ConversationsRequestBuilder` with no `.setLimit(n)`, or a bad Region) | Add `.setLimit(30)`; confirm Region matches the dashboard app |\n| Conversations empty | New\u002Fseeded app has no conversations yet, or scope excludes them | Send a first message; check `conversationsRequestBuilder` scope (`user`\u002F`group`) matches intent |\n| `login()` fails \"user not found\" | UID does not exist in the app | Use a real UID (Dashboard → Users; fresh apps seed `cometchat-uid-1`) — never a guessed `superhero*` |\n| Nothing updates live | Missing\u002Fduplicated listeners, or StrictMode double-mount | Add listeners with a stable ID, remove on unmount; guard the init\u002Flogin in-flight (`cometchat-react-v7-patterns`) |\n| Roster rows appear TWICE + ~30 \"duplicate key\" errors (dev only) | React **StrictMode** double-invokes effects; the roster drop-ins `CometChatUsers`\u002F`CometChatGroups`\u002F`CometChatGroupMembers` double-append (kit de-dupe gap; `CometChatConversations` is unaffected) | A dev-only StrictMode artifact — gone in `vite build`\u002Fprod. Do **NOT** remove StrictMode to \"fix\" it; verify the roster in a production build. Kit issue — report upstream |\n| Localized keys shown raw (e.g. `group_info`) | Wrong\u002Fstale i18n key or provider missing | Use the kit component \u002F correct key; ensure `CometChatProvider` wraps the tree |\n| Works in dev, blank in prod | Wrong env prefix → Auth Key\u002FApp ID missing in the bundle | Fix the bundler prefix; grep the build (`cometchat-react-v7-production`) |\n| `version_conflict` on detect | Project on UI Kit v6 while skills target v7 | STOP and reconcile — migrate v6→v7 (`cometchat-react-v7-migration`), or stay on v6 by installing the older **v4 skills pack** (it targets the v6 UI Kit) |\n\n## When the table does not cover it\nOpen the browser console + network tab: a `401` is auth (bad token\u002FAuth Key\u002FRegion), a `402` is a plan-gated feature (e.g. Search — enable it in the dashboard), a `4xx` \"no conversation yet\" is benign. Then fetch the feature's page via `cometchat-react-v7-core\u002Freferences\u002Fdocs-map.md`. Never diagnose from `node_modules`\u002F`.d.ts` or memory.\n\n## Verify it works\nInit+login resolve before the surface renders · the surface has real dimensions (not a sliver) · conversations render or show the kit's empty state (not the error state) · a message sends and arrives live · no raw localization keys · production build carries no Auth Key.\n\n## What NOT to do\nDo not silence the error boundary to hide a thrown call; do not hard-code a UID to dodge \"user not found\"; do not read kit internals to work around a missing prop — fetch the documented prop instead.\n","> **Ground truth:** `@cometchat\u002Fchat-uikit-react@7`. Symbols\u002Fsignatures are verified against `cometchat-react-v7-core` + its catalog and FETCHED via `references\u002Fdocs-map.md`; the rules referenced (init order, layout sizing, credentials) are `RULES.md`. This diagnostics catalog is cross-checked against the live `{DOCS_BASE}\u002Fui-kit\u002Freact\u002Ftroubleshooting.md` page (base + paths in `cometchat-react-v7-core\u002Freferences\u002Fdocs-map.md`), and adds the host-side\u002Fruntime symptoms it doesn't cover.\n\n## Companion skills (read first)\n- `cometchat-react-v7-core` — the correct init→login→render order, credentials, and the reflow-free layout the fixes below restore.\n\n## Use this skill when\nA React CometChat integration compiles but misbehaves at runtime: blank, empty, unresponsive, or throwing.\n\n## Start here — React fails on the ORDER and the BOX\nTwo causes explain most \"it's blank\":\n1. **A kit component rendered before `init()` + `login()` resolved.** The surface must be gated on the resolved logged-in user. Rendering it eagerly (or during SSR) yields an empty\u002Ferroring pane.\n2. **The container has no height.** The kit fills its parent; a parent at `height:auto`\u002F`0` collapses it to a sliver. This is a host CSS defect, not a kit bug (`RULES.md` → Layout \u002F sizing).\n\n## Symptom → cause → fix\n| Symptom | Likely cause | Fix |\n| --- | --- | --- |\n| Blank\u002Fwhite, no errors | Surface rendered before init+login resolved | Gate render on the resolved user; keep `CometChatErrorBoundary` for a visible fallback |\n| Blank during SSR \u002F `window is not defined` | A kit component imported or rendered on the server (Next.js, Astro, Remix) | Render the surface client-only — `\"use client\"` + `dynamic(..., { ssr:false })` (Next), `client:only` (Astro); see core `references\u002Fssr.md` |\n| Surface ~0px \u002F cramped top-left | Ancestor chain has no height | `html,body,#root{height:100%}` + a pinned surface (`100dvh` full-app) + panes `min-height:0`; see core `references\u002Flayout.md` |\n| \"OOPS! Looks like something went wrong\" | The kit's error state — a call threw (often a custom `ConversationsRequestBuilder` with no `.setLimit(n)`, or a bad Region) | Add `.setLimit(30)`; confirm Region matches the dashboard app |\n| Conversations empty | New\u002Fseeded app has no conversations yet, or scope excludes them | Send a first message; check `conversationsRequestBuilder` scope (`user`\u002F`group`) matches intent |\n| `login()` fails \"user not found\" | UID does not exist in the app | Use a real UID (Dashboard → Users; fresh apps seed `cometchat-uid-1`) — never a guessed `superhero*` |\n| Nothing updates live | Missing\u002Fduplicated listeners, or StrictMode double-mount | Add listeners with a stable ID, remove on unmount; guard the init\u002Flogin in-flight (`cometchat-react-v7-patterns`) |\n| Roster rows appear TWICE + ~30 \"duplicate key\" errors (dev only) | React **StrictMode** double-invokes effects; the roster drop-ins `CometChatUsers`\u002F`CometChatGroups`\u002F`CometChatGroupMembers` double-append (kit de-dupe gap; `CometChatConversations` is unaffected) | A dev-only StrictMode artifact — gone in `vite build`\u002Fprod. Do **NOT** remove StrictMode to \"fix\" it; verify the roster in a production build. Kit issue — report upstream |\n| Localized keys shown raw (e.g. `group_info`) | Wrong\u002Fstale i18n key or provider missing | Use the kit component \u002F correct key; ensure `CometChatProvider` wraps the tree |\n| Works in dev, blank in prod | Wrong env prefix → Auth Key\u002FApp ID missing in the bundle | Fix the bundler prefix; grep the build (`cometchat-react-v7-production`) |\n| `version_conflict` on detect | Project on UI Kit v6 while skills target v7 | STOP and reconcile — migrate v6→v7 (`cometchat-react-v7-migration`), or stay on v6 by installing the older **v4 skills pack** (it targets the v6 UI Kit) |\n\n## When the table does not cover it\nOpen the browser console + network tab: a `401` is auth (bad token\u002FAuth Key\u002FRegion), a `402` is a plan-gated feature (e.g. Search — enable it in the dashboard), a `4xx` \"no conversation yet\" is benign. Then fetch the feature's page via `cometchat-react-v7-core\u002Freferences\u002Fdocs-map.md`. Never diagnose from `node_modules`\u002F`.d.ts` or memory.\n\n## Verify it works\nInit+login resolve before the surface renders · the surface has real dimensions (not a sliver) · conversations render or show the kit's empty state (not the error state) · a message sends and arrives live · no raw localization keys · production build carries no Auth Key.\n\n## What NOT to do\nDo not silence the error boundary to hide a thrown call; do not hard-code a UID to dodge \"user not found\"; do not read kit internals to work around a missing prop — fetch the documented prop instead.\n",{"name":5,"license":15,"metadata":50,"description":7,"compatibility":54},{"tags":51,"author":52,"version":53},"cometchat react v7 troubleshooting debug diagnostics blank-screen version-conflict","CometChat","1.0.0","@cometchat\u002Fchat-uikit-react ^7 (7.1.x–7.2.x verified); React 18–19; Vite \u002F Next.js \u002F CRA \u002F React Router \u002F Astro","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-v7-troubleshooting",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-v7-troubleshooting",{"tool":71,"command":72},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-v7-troubleshooting",{"tool":74,"command":75},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill cometchat-react-v7-troubleshooting","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcometchat\u002Fcometchat-skills\u002Fskills\u002Fcometchat-react-v7-troubleshooting\u002FSKILL.md",true,[],[80,89,97,105,113,121],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":84,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":88},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":88},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":88},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":88},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":88},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":125,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":88},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]