ROS Skill

CLI to inspect and control ROS/ROS2 robots over rosbridge WebSocket - topics, services, nodes, actions.

Works with setup

Test report

Verdict
Works with setup
Score
9.2/10
Tested
Jul 15, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 9ed3961

The CLI itself is real and clean - ran it live against a closed local port and got well-formed `{"error": "[Errno 61] Connection refused"}` JSON on every command exactly as documented - but nothing it does is useful until a rosbridge_server is already running on a reachable robot/simulator, which is a genuine manual setup step this environment doesn't have.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 8/10
  • Docs & honesty 5/5

What ROS Skill does

Wraps a rosbridge WebSocket connection in a single Python CLI (ros_cli.py) so Claude can list/subscribe/publish topics, call services, inspect nodes, and get/set ROS2 parameters and actions, all returning structured JSON. Triggers when the user asks about ROS/ROS2 topics, services, nodes, parameters, actions, or robot movement/sensor interaction.

How to install ROS Skill

git clone https://github.com/lpigeon/ros-skill
cd ros-skill
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/ros-skill

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger ROS Skill

  • /ros-skill CLI to inspect and control ROS/ROS2 robots over rosbridge WebSocket - topics, services, nodes, actions.

It also activates on plain-language prompts like these:

  • connect to my robot and show me the /cmd_vel message schema
  • move the robot forward for two seconds then stop it safely
  • list all active ros2 topics and subscribe to the odometry one

Frequently asked questions

Is the ROS Skill skill free?
Yes. The skill itself is free from lpigeon/ros-skill. SkillProof publishes the install command and an independent test verdict at no cost.
Does ROS Skill work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 15, 2026. Verdict: Works with setup. The CLI itself is real and clean - ran it live against a closed local port and got well-formed `{"error": "[Errno 61] Connection refused"}` JSON on every command exactly as documented - but nothing it does is useful until a rosbridge_server is already running on a reachable robot/simulator, which is a genuine manual setup step this environment doesn't have.
What is the ROS Skill SkillProof Score?
9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.
How do I install ROS Skill?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use ROS Skill with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.