Stream Agent Skills

Give your AI coding agent the ability to build, query, and manage Stream - Chat, Video, Feeds, Moderation, Swift/iOS and Android integrations, and React Native Chat.

Install

npx skills add GetStream/agent-skills

That's the only command you ever need. It installs the router (stream) plus every specialist skill below — and even if you install the router alone, it silently pulls in whatever sub-skill a task needs, on demand. Use /stream for generic Stream routing, or invoke a sub-skill directly with /stream-cli, /stream-docs, /stream-builder, /stream-swift, /stream-android, or /stream-react-native.

Install - direct from GitHub (no third-party CLI)

If you'd rather not route through skills.sh, clone this repo into your skills directory:

# Claude Code
git clone https://github.com/GetStream/agent-skills ~/.claude/skills/stream-pack

# Or download a tagged release tarball
curl -L https://github.com/GetStream/agent-skills/archive/refs/heads/main.tar.gz | tar -xz -C ~/.claude/skills/

This is byte-for-byte the same content npx skills add installs, fetched directly from GitHub.

Skills

Core

Skill	Purpose	When to use
/stream	Router - classifies intent and dispatches	Always start here if you don't know which sub-skill applies

The router skill at skills/stream/ owns core web, CLI, docs, and peer-pack routing rules. Platform sub-skills can add their own RULES.md.

Sub-skills

Skill	Purpose	When to use
/stream-cli	Query Stream data, run stream api / config / auth, install the CLI binary	"list channels", "show flagged", "find users", stream api ..., "install the CLI"
/stream-docs	Search live SDK documentation from getstream.io	Explicit SDK token (Chat React, Video iOS, ...), "docs", "how do I ... in "
/stream-builder	Scaffold a new app, or add Chat/Video/Feeds/Moderation to an existing one	"build me a ... app", "scaffold", "add Chat to this app", "integrate Video"
/stream-swift	Build or integrate Stream in Swift/SwiftUI/UIKit/iOS apps	Swift, SwiftUI, UIKit, iOS, Xcode
/stream-android	Build or integrate Stream in Android/Jetpack Compose apps	Android, Jetpack Compose, Kotlin, Android Studio, Gradle
/stream-react-native	Create, build, or integrate Stream Chat React Native in RN CLI or Expo apps	React Native, Expo, stream-chat-react-native, stream-chat-expo

What gets installed

This pack is markdown only - no code, no postinstall scripts, no binaries. Two install paths touch the network; each is listed below so you can audit before running.

Step	Trigger	What it does	Source
npx skills add GetStream/agent-skills	Manual, by you	Fetches this repo's markdown into your skills directory via the skills.sh CLI (source).	GitHub (GetStream/agent-skills)
curl -sSL https://getstream.io/cli/install.sh | bash	Agent runs only after you approve	Installs the stream CLI binary. Skipped entirely for docs-only usage (/stream-docs). Full audit of what the installer does - including SHA-256 verification and TTY confirmation - in skills/stream-cli/bootstrap.md.	getstream.io/cli/
Frontend skill installs (builder only)	Agent asks first, then runs	Installs three third-party skill packs for UI scaffolding - see below.	GitHub (listed)

Frontend skills (builder only)

When you ask the agent to scaffold a new app or enhance an existing one via /stream-builder, Step 3 can install three helper skill packs. The agent surfaces the full list and waits for your confirmation before running any install.

Skill	Purpose	Source
vercel-react-best-practices	React/Next.js idioms	vercel-labs/agent-skills
web-design-guidelines	Generic UI design polish	vercel-labs/agent-skills
frontend-design	Frontend structure	anthropics/skills

Decline and the builder still runs - Stream reference files cover the SDK wiring; the frontend skills only tune generic UI quality. The CLI and docs skills never trigger these installs.

What your agent can do

• Scaffold a full app - Next.js + Tailwind + Stream SDKs, wired end-to-end in one shot (/stream-builder)
• Add products to existing apps - drop Chat, Video, or Feeds into a project that's already running (/stream-builder)
• Build and extend Swift apps - wire Stream into SwiftUI or UIKit Xcode projects with iOS-specific setup patterns (/stream-swift)
• Build and extend Android apps - wire Stream into Jetpack Compose Android Studio / Gradle projects with Android-specific setup patterns (/stream-android)
• Build and extend React Native apps - wire Stream Chat into Expo or RN CLI projects (/stream-react-native)
• Query live data - "any active calls?", "show flagged messages", "list my channels" - natural language to CLI (/stream-cli)
• Set up moderation - blocklists, automod config, and content policies via the Stream CLI (/stream-cli)
• Answer SDK questions - token patterns, strict mode, client/server instantiation, theme wiring (/stream-builder or /stream-docs)
• Search live SDK docs - ask questions about any Stream SDK, framework, or version; answers come verbatim from getstream.io with citations (/stream-docs)

How it works

The skill pack is markdown only - no code, no build step. The generic /stream router handles core Stream routing, docs, CLI, builder, and declared peer platform packs. Direct sub-skills such as /stream-react-native can also be invoked explicitly.

Intent	Sub-skill
Build a new app	stream-builder (Track A)
Add a product to an existing app	stream-builder (Track E)
Data queries and CLI operations	stream-cli (Track B)
Install the Stream CLI	stream-cli (Track C)
SDK wiring during builder/enhance	stream-builder + its sdk.md and references/*.md
Build or integrate a React Native CLI/Expo app	stream-react-native + its sdk.md and references/*.md
Search the official SDK documentation (no CLI needed)	stream-docs (Track D)
Build or integrate a Swift/iOS app	stream-swift + its builder.md, sdk.md, and references/*.md
Build or integrate an Android app	stream-android + its builder.md, sdk.md, and references/*.md

Cross-cutting rules (secrets, login screen, strict mode, package manager, base UI, moderation Dashboard-only, ...) live once in skills/stream/RULES.md and apply to every sub-skill.

Contents

• skills/stream/ - Router skill
  • SKILL.md - entrypoint: intent classifier, dispatch table, hand-off rules
  • RULES.md - non-negotiable rules, stated once
• skills/stream-cli/ - CLI sub-skill
  • SKILL.md - CLI workflow, credential resolution, exit-code recovery
  • cli-cookbook.md - body examples for tricky endpoints, filter/sort syntax
  • bootstrap.md - CLI binary installer audit
  • preflight.md - project signals + CLI gate + auth check (used by builder too)
• skills/stream-docs/ - Docs sub-skill
  • SKILL.md - live documentation lookup with cited sources
• skills/stream-builder/ - Builder sub-skill
  • SKILL.md - scaffold execution (Steps 0-7)
  • builder-ui.md - UI shell, login screen, theme
  • enhance.md - add Stream to an existing app
  • sdk.md - cross-cutting SDK wiring patterns
  • references/ - per-product setup, gotchas, and component blueprints
• skills/stream-swift/ - Swift/iOS sub-skill
  • SKILL.md - entrypoint: intent classifier, local project detection, module pointers
  • RULES.md - Swift/iOS non-negotiable rules
  • builder.md + sdk.md - shared Swift app integration flow and SDK ownership patterns
  • references/ - product/framework-specific Swift references and blueprints
• skills/stream-react-native/ - React Native Chat sub-skill
  • SKILL.md - RN/Expo intent classifier, project detection, module pointers
  • RULES.md - Chat RN non-negotiable rules
  • credentials.md - API key, token, and optional requested demo-data flow
  • builder.md + sdk.md - shared RN CLI and Expo integration flow
  • references/ - llms.txt docs lookup, Chat RN setup, gotchas, and screen blueprints
• skills/stream-android/ - Android sub-skill
  • SKILL.md - entrypoint: intent classifier, local project detection, module pointers
  • RULES.md - Android non-negotiable rules
  • builder.md + sdk.md - shared Android app integration flow and SDK ownership patterns
  • references/ - product/framework-specific Android references and blueprints