stream-docs
Search live Stream SDK documentation for Chat, Video, Feeds, and Moderation. Look up how a Stream React/iOS/Android/Node/Flutter/Unity/Angular hook, component, or method works. Answer how-to questions about any Stream SDK across every framework and version. Triggers on 'docs', 'documentation', expli
By getstream · 694 installs
npx skills add getstream/agent-skills --skill stream-docs
Source repository · Upstream listing
Stream Docs search (live SDK documentation)
Read first (every session): Glob ../stream/SKILL.md and Read [ ../stream/RULES.md ](../stream/RULES.md) (both ship with this skill) RULES.md includes a Peer skills table for installing/invoking any other pack skills on demand.
Answer questions from Stream's official SDK documentation by fetching live pages from getstream.io . Covers Chat, Video, Activity Feeds, and Moderation across every framework and version.
Docs index: https://getstream.io/cli/llms.txt
No CLI gate, no up front shell. This skill never invokes Write, Edit, npm, scaffold tools, or Bash(getstream ) . Pure docs questions with an explicit SDK reach WebFetch without running any shell command. A small read only probe runs only on demand inside Step 1a below when the SDK can't be resolved from the user's input. If the user's question requires running the CLI or building code, offer to switch the user re enters via the stream router or the stream builder skill.
Honesty rules (read before anything else)
These rules are non negotiable. Read them before every response.
1. Announce inference only when it happened. If you picked an SDK/version from anything other than explicit user input, say so in the first sentence but only on the turn the inference happened:
"Looking in Chat React v13 (detected from your package.json)..."
"Inferring Video from your question about 'calls' let me know if you meant something else..."
On follow ups within the same SDK, stay silent the user knows what's loaded. Only re announce when the SDK changes. For explicit input (e.g. /stream Chat React v14 ), no preamble is needed go straight to the answer.
2. Write for humans, not for the skill. Users don't know (or care) how this skill works they want their answer. No internal workflow terminology, status narration, or process commentary should ever appear in output. The answer itself proves the fetch worked.
Never say:
Bad (leaks internals) Why it's bad
"framework index", "CLI index", "the index" Internal term call it "the docs" or skip the label
"slug", "per llms.txt ", "per Step 1d" Workflow jargon the user never sees
"docs map", "table of contents" Sounds like a data dump, not an answer
"Reading the docs search module and searching..." Meta narration of your own tool use
"Fetching the Video Android framework index..." Process commentary
"the versioned URL returned 200", "index is in context now" Fetch status users assume success
"Still in Chat React v14" on a follow up Redundant; users know they didn't switch
When an SDK has just loaded (explicit invocation like /stream Video Android ), open with a warm human sentence, then get to the point. Good examples:
" Video Android docs loaded. Here are good starting points:"
" Chat React v14 (Beta) docs loaded what do you want to look up?"
"Got the Video iOS docs. A few areas you can explore:"
Then list actual pages/topics. Do not call it a "map", "index", or "TOC" just present the content.
List formatting rules (apply anywhere you emit links SDK loaded intros, "see also" notes, recovery messages):
Every link is a markdown link with a short title: [Installation](https://getstream.io/chat/docs/sdk/react/basics/installation.md) never a bare URL in prose, never a URL wall, never comma separated URLs inline.
One link per line. Readers scan vertically. Breaking five links onto one line hides four of them.
Curate, don't dump. When presenting starting points, pick 5 8 well chosen entries grouped under short category headings. An exhaustive 30 URL inventory is a sitemap, not an intro. If the user wants the full index, they'll ask.
Group with short bold headings, not prose prefixes. Use Getting started on its own line with links below it not Getting started: link1, link2, link3 .
Example good:
Example bad (URL wall):
3. Only answer from fetched content. No training data, no assumptions, no "I think it's probably..." If you didn't fetch it in this conversation, you don't know it.
4. Cite the source page URL in every answer. Format: Source: [Page Title](https://getstream.io/...) a complete, clickable URL.
5. URL grounding every URL and every slug you use must come from a tool result in this conversation. Slugs come from llms.txt (fetched in Step 1b). Page URLs come from the framework index WebFetch in Step 2. Never construct a slug or URL from memory, from a pattern, or from "what it probably is." Many Stream URLs look guessable but aren't chat sdk react vs chat react vs chat javascript all exist and point to different products.
No placeholders. A citation must be a complete https:// URL. Forbidden:
Ellipses: https://getstream.io/video/docs/android/... X
Patterns or templates: https://getstream.io/chat/docs/sdk/{framework}/... X
Descriptive stand ins: Video Android docs index (table of contents) X
Wildcards: /components/ .md X
If you don't have the exact page URL, your options are:
(a) Cite the index URL you actually fetched (e.g. https://getstream.io/cli/docs/video android.md ) a real fetched URL is always valid
(b) Re fetch the index asking for raw URLs
(c) Tell the user "I have the SDK overview but need to fetch the specific page for a precise link"
A citation you made up isn't a citation it's a fabrication dressed as one.
6. If the docs don't cover it, say so. Don't fill gaps with guesses. It's better to say "I couldn't find information about X" than to give a wrong answer.
7. Don't invent cross references. If a page mentions a topic but no dedicated page exists in the index, say "the docs mention this but don't have a dedicated page" don't guess the URL.
8. Code examples from docs are authoritative. Use them verbatim unless the user's context requires adaptation.
9. Multi page answers allowed , but fetch at most 3 pages per question. If more are needed, point the user to the framework index URL instead.
Invocation
This skill is reached through /stream (router routes here based on signals) or directly via /stream docs . The same input shapes work either way:
Examples that route here:
Shortcut: SDK named with no question
If the user invokes /stream Chat React v14 (or any product/framework/version) with no follow up question, fetch https://getstream.io/cli/llms.txt , resolve the slug, fetch the framework index, and present 5 8 curated starting points using the list formatting rules above. Wait for the user to pick a topic.
Shortcut: bare /stream with no args
That's handled by the stream router (it lists the sub skills). Don't intercept it here.
Step 1: Identify the SDK
Precedence
1. Explicit user input always wins. If the user named a product/framework/version ( /stream Chat React v14 ), use that even if the project contains a different SDK.
2. Project detection provides context when the user asked a question without naming an SDK.
3. Keyword inference is the last resort, and only for unambiguous (tier 1) terms.
Resolution order for "question without named SDK"
Stop at the first step that gives a confident answer:
1. Run project detection (Step 1a below)
2. Check for tier 1 keyword match (Step 1c, unambiguous terms)
3. Combine project + tier 2 keyword (tier 2 is only safe if project already narrowed it)
4. Still unclear ask: "Which Stream product is this about Chat, Video, Feeds, or Moderation? And which SDK/framework?"
Step 1a Project detection
Check project signals first. Reuse any project signals already in conversation context PKG (Stream npm packages with versions) and NATIVE (non npm project files). If they aren't available yet, run the probe below.
Only run a fresh probe if:
project signals hasn't run yet in this conversation (rare usually means you're answering before the router classified)
project signals found nothing but the user's question implies a project file exists (e.g., the user said "in my Flutter project" but NATIVE was empty when probed)
A scaffold or install completed mid conversation and may have added packages
Fallback probes (when project signals are missing)
npm:
Non npm:
Either way, extract the major version from semver (e.g. "stream chat react": "^13.2.0" 13 ) for Chat SDK slugs, then map packages to product + framework using Step 1b (which resolves to a slug via llms.txt ).
Multiple SDKs detected
If a tier 1 keyword clearly matches one use that one, announce the match
If ambiguous ask: "I found Chat React v13 and Video React in your project. Which is this question about?"
Step 1b Resolve to a slug via llms.txt
You MUST fetch https://getstream.io/cli/llms.txt before constructing any cli/docs/ .md URL for the first time in a conversation. llms.txt is the live, authoritative list of every SDK slug Stream publishes don't guess slugs from memory. chat sdk react , chat react , and chat javascript all look plausible but point to different products, and a wrong slug silently returns the wrong docs. llms.txt is the only source of truth; once fetched, it stays in context for the rest of the conversation.
Fetch prompt:
"Return the raw list of SDK slugs and their section headers from llms.txt, verbatim. Do not summarize."
Then scan the result for the slug whose name + context matches your product + framework. The sections below tell you what to match , but the slug you use must exist in llms.txt .
Slug name patterns (scanning hints)
Slugs follow predictable patterns use these to guide your scan, then verify the match exists in llms.txt :
Chat UI SDKs: chat sdk {framework} (e.g. chat sdk react , chat sdk ios ). Versioned see Step 1d .
Chat low level / server side: chat {framework} (e.g. chat javascript , chat node , chat python ). No version suffix.
Video: video {framework} (e.g. video react , video ios , video api ). No version suffix.
Feeds (v3): activity feeds {framework} (e.g. activity feeds react , activity feeds node ). Feeds v2 exists only for server side languages append v2 to one of: node , python , go golang , java , ruby , php , dotnet csharp , javascript . There are no v2 slugs for React, React Native, iOS, Android, or Flutter.
Moderation: moderation {framework} (e.g. moderation node , moderation python ). No version suffix.
If your constructed slug isn't in llms.txt , don't use it. If you can't find a match at all, tell the user the combination isn't in the docs and list what is available.
Framework name normalization
Normalize user input to the tokens slugs use:
User says Use
React react
React Native react native
iOS, Swift ios (Chat low level: ios swift )
Android, Kotlin android
Flutter, Dart flutter (Chat low level: flutter dart )
Angular angular
Node, NodeJS, Node.js node
Python python
Go, Golang go golang
.NET, C , CSharp dotnet csharp
PHP php
Ruby ruby
Java java
JavaScript, JS javascript
Unity unity
Unreal unreal
ESP32 esp32
npm packages product + framework
When Step 1a detected a package, map it to a product + framework, then find the matching slug in llms.txt :
Package Product + framework
stream chat react Chat + React (UI)
stream chat react native or stream chat expo Chat + React Native (UI)
stream chat angular Chat + Angular (UI)
stream chat alone Chat JS (client) or Chat Node (server) see special case
@stream io/video react sdk Video + React
@stream io/video react native sdk Video + React Nativ