stream-react
Stream React (web) - scaffold + enhance + audit + migrate
Read first (every session): Read
RULES.md(React/Next.js non-negotiables) and the cross-cutting../stream/RULES.md. Where the two files state the same rule differently (e.g. Strict mode protection, Package manager), this pack'sRULES.mdwins for React work. Glob../stream/SKILL.md; if empty, install withnpx skills add GetStream/agent-skills --s stream -y.Peer: this pack hands every CLI action (preflight, credentials, auth, every
stream apicall) tostream-cli. Glob its path from../stream/peers.yaml; install silently if missing (npx skills add GetStream/agent-skills --s stream-cli -y). See../stream-cli/preflight.md.
This skill builds, enhances, audits, and migrates Stream Chat, Video, and Feeds in React / Next.js web apps - the default pack for all web React work. It covers four tracks:
- Track A - Scaffold a new app: Steps 0-7 below. Use when the cwd is empty / new and the user said "build me a ... app".
- Track E - Enhance an existing app: see
enhance.md. Skips scaffold + theme; reuses the same SDK wiring and component blueprints. - Track F - Audit an existing integration (read-only): for "audit/review my video integration", "check my app against best practices", "is my video app production-ready?", "what am I missing before launch?". Video only: load the Integration best-practices audit section in
references/VIDEO.mdand follow its protocol - it has a Video-specific checklist + output contract. If the user asks to audit Chat or Feeds, say up front there is no dedicated best-practices checklist for those yet, then do a general docs-based review (fetch the relevant pages fromreferences/DOCS.mdand check the app against them) rather than applying the Video checklist. Skip preflight, auth, the CLI, and all build steps - this track only reads the app and reports findings. Fix issues only if the user then asks. - Track M - Migrate / upgrade an SDK version: see
migrate.md. For "upgrade stream-chat-react to v14", "migrate to the new SDK", "bump my Stream version". Docs-driven: detect the installed version, fetch the matching release guide, apply it. Never migrate from memory.
Flow dispatch - choose exactly one
- Track A: hand off to
stream-clifor preflight, then continue to Start and execute Steps 0-7. - Track E: hand off to
stream-clifor preflight, then Read and executeenhance.md. Do not enter Start or any scaffold task. - Track F: skip preflight and go directly to the audit in
references/VIDEO.md. Do not enter Start or any build step. - Track M: skip preflight and Read
migrate.mdfirst; it fetches the live release guide before any edit. Do not enter Start or any scaffold task.