Agent skill

Ralph Protocol

by GetStream in GetStream/stream-chat-react

Collaboration protocol for Ralph loop (Plan → Act → Reflect → Refine).

Custom licenceAuto-check passedAgent Workflows

Install Ralph Protocol

skills CLI
$ npx skills add GetStream/stream-chat-react --skill ralph-protocol -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GetStream/stream-chat-react ralph-protocol --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GetStream/stream-chat-react.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/ralph-protocol .claude/skills/ralph-protocol && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ralph-protocol
GitHub stars
845
Token cost
~949 tokens
SKILL.md length
345 words
Files
2
Skills in repo
5
Repo updated
First seen
Licence
Custom licence

At a glance

Collaboration protocol for Ralph loop (Plan → Act → Reflect → Refine).

  • Working from spec files in specs/<name/ (goal.md/spec.md
  • SKILL.md covers Required Files, Workflow, Task ownership (critical) and Commit scope, plus 2 more sections
  • Calls git
  • Executing tasks in a shared plan

What it does

Ralph Protocol is an agent skill from GetStream/stream-chat-react. Collaboration protocol for Ralph loop (Plan → Act → Reflect → Refine). Use when working from spec files in specs/<name/ (goal.md/spec.md, plan.md, state.json, decisions.md); when executing tasks in a shared plan; or when the user mentions Ralph, multi-agent, or file-based collaboration.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Agent Workflows, covering Autonomous loops. It works with React. The repository describes itself as: React Chat SDK ➜ Stream Chat 💬.

When your agent uses it

  • Working from spec files in specs/<name/ (goal.md/spec.md
  • Executing tasks in a shared plan
  • The user mentions Ralph
  • File-based collaboration

Example prompts

  • “/ralph-protocol”

What it can do on your machine

Read from SKILL.md and the folder at commit 1af035e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ralph Protocol loads about 949 tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 345 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~949

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 345 words (~949 tokens).

“Files are the source of truth. All agents share memory via files. No silent decisions. Always update state after acting. Prefer small, explicit updates.”

— opening of SKILL.md by GetStream, Custom licence
name
ralph-protocol

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .cursor/skills/ralph-protocol of GetStream/stream-chat-react.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 1af035e

Compare with similar skills

Ralph Protocol next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ralph Protocol compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph Protocol this skillGetStream/stream-chat-react845—~949Automated safety check: PassCustom licence
Lexora Buddy AnimationuseLexora/Lexora548—~232Automated safety check: PassAGPL-3.0
Tinyplacetinyhumansai/tiny.place138—~5.1kAutomated safety check: PassGPL-3.0-or-later
Autonomous Agentsdavila7/claude-code-templates32k3 repos~553Automated safety check: PassMIT
Autonomous Agentsaiskillstore/marketplace4304 repos~7.5kAutomated safety check: PassNone
Agent Patterns Cataloghashgraph-online/awesome-codex-plugins1.2k—~445Automated safety check: PassApache-2.0

Similar skills

  • Lexora Buddy Animation

    useLexora/Lexora

    A skill your agent uses when the user asks Lexora Buddy to move, emote, celebrate, rest, or perform a visible desktop-pet action.

    548 GitHub stars~232 tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Tinyplace

    tinyhumansai/tiny.place

    Live on tiny.place (the agent-to-agent social network) like a person lives on a social app — entirely through the tinyplace CLI.

    138 GitHub stars~5.1k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Autonomous Agents

    davila7/claude-code-templates

    Autonomous agents are AI systems that can independently decompose goals, plan actions, execute tools, and self-correct without constant human guidance.

    32k GitHub starsUsed in 3 repos~553 tokens
    Agent WorkflowsAuto-check passed
  • Autonomous Agents

    aiskillstore/marketplace

    Autonomous agents are AI systems that can independently decompose goals, plan actions, execute tools, and self-correct without constant human guidance.

    430 GitHub starsUsed in 4 repos~7.5k tokens
    Agent WorkflowsAuto-check passed
  • Agent Patterns Catalog

    hashgraph-online/awesome-codex-plugins

    AI Agent 架构模式目录。提供 ReAct、Multi-Agent Conversation、Multi-Agent Workflow、 RAG Agent、Tool-Use Agent、Autonomous Agent 六种核心模式的参考架构、组件拓扑、 数据流、设计决策和框架无关的最佳实践。供 agent-dev-workshop Phase 2 调用。

    1.2k GitHub stars~445 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Tanstack AI

    secondsky/claude-skills

    TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.

    227 GitHub starsUsed in 1 repo~3.6k tokens
    AI & LLM EngineeringAuto-check: notes

More from GetStream/stream-chat-react

  • Make Plans

    GetStream/stream-chat-react

    Structures plan.md files for parallel, non-overlapping agent work.

    845 GitHub stars~764 tokensUpdated today
    Auto-check passed
  • Worktrees

    GetStream/stream-chat-react

    Creates and manages git worktrees for isolated plan execution.

    845 GitHub stars~794 tokensUpdated today
    Auto-check passed
  • Accessibility

    GetStream/stream-chat-react

    Maintain WCAG-focused accessibility in stream-chat-react. An agent skill from GetStream/stream-chat-react.

    845 GitHub stars~5k tokensUpdated today
    Auto-check passed
  • Dev Patterns

    GetStream/stream-chat-react

    Styling and structure conventions for stream-chat-react. An agent skill from GetStream/stream-chat-react.

    845 GitHub stars~748 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Ralph Protocol

What does Ralph Protocol do?

Collaboration protocol for Ralph loop (Plan → Act → Reflect → Refine). Ralph Protocol is an agent skill from GetStream/stream-chat-react. Collaboration protocol for Ralph loop (Plan → Act → Reflect → Refine).

When should I use Ralph Protocol?

Ralph Protocol fits situations like: working from spec files in specs/<name/ (goal.md/spec.md; executing tasks in a shared plan; the user mentions Ralph; file-based collaboration.

How do I install Ralph Protocol in Claude Code?

Run `npx skills add GetStream/stream-chat-react --skill ralph-protocol -a claude-code`. Or copy the skill folder (.cursor/skills/ralph-protocol in GetStream/stream-chat-react) into .claude/skills/ralph-protocol in your project. Claude Code loads it when a task matches its description.

How do I install Ralph Protocol in Codex?

Run `npx skills add GetStream/stream-chat-react --skill ralph-protocol -a codex`. Or copy the skill folder (.cursor/skills/ralph-protocol in GetStream/stream-chat-react) into .agents/skills/ralph-protocol in your project. Codex loads it when a task matches its description.

Can I use Ralph Protocol in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GetStream/stream-chat-react --skill ralph-protocol -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ralph-protocol, .gemini/skills/ralph-protocol, .github/skills/ralph-protocol and .opencode/skills/ralph-protocol in your project.

What does Ralph Protocol need to run?

Going by SKILL.md and its folder, Ralph Protocol needs the command-line tools its instructions call (git).

Does Ralph Protocol access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ralph Protocol safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ralph Protocol use?

Ralph Protocol has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Ralph Protocol use?

About 949 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ralph Protocol?

Skills that share tags, products or a category with Ralph Protocol: Lexora Buddy Animation (useLexora/Lexora, 548 stars), Tinyplace (tinyhumansai/tiny.place, 138 stars), Autonomous Agents (davila7/claude-code-templates, 32k stars) and Autonomous Agents (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph Protocol?

GetStream (a GitHub organization) maintains it in GetStream/stream-chat-react, which has 845 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: GetStream/stream-chat-react on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.