What is claude-ros2-skills?

leehyunbin0131/claude-ros2-skills — explained in plain English

Analysis updated 2026-07-26

★ 12PythonAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Prevents AI robotics mistakes
      Three-step verification loop
      11 skills for Claude Code
    Problem solved
      Code looks correct but fails
      Incompatible pub/sub settings
      Inverted coordinate frames
    Evaluation
      A/B tested with and without skills
      Checked against live ROS 2
      Tested in Gazebo simulation
    Tech stack
      Python
      ROS 2 Jazzy Jalisco
      Ubuntu 24.04
      Gazebo simulation
    Audience
      Developers using AI for robotics
      ROS 2 robot software builders

mindmap root((repo)) What it does Prevents AI robotics mistakes Three-step verification loop 11 skills for Claude Code Problem solved Code looks correct but fails Incompatible pub/sub settings Inverted coordinate frames Evaluation A/B tested with and without skills Checked against live ROS 2 Tested in Gazebo simulation Tech stack Python ROS 2 Jazzy Jalisco Ubuntu 24.04 Gazebo simulation Audience Developers using AI for robotics ROS 2 robot software builders

What do people build with it?

USE CASE 1

Help Claude Code generate ROS 2 Jazzy code that runs without runtime errors.

USE CASE 2

Verify AI-written robot code against a live ROS 2 installation before deployment.

USE CASE 3

Reduce broken publisher and subscriber pairs caused by mismatched communication settings.

USE CASE 4

Test generated robotics code in a Gazebo simulation environment.

What is it built with?

PythonROS 2 JazzyUbuntu 24.04Gazebo

How does it compare?

	leehyunbin0131/claude-ros2-skills	aim-uofa/reasonmatch	airbone42/360-data-athlete
Stars	12	12	12
Language	Python	Python	Python
Setup difficulty	moderate	hard	hard
Complexity	3/5	5/5	4/5
Audience	developer	researcher	general

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ROS 2 Jazzy Jalisco installed on Ubuntu 24.04, plus a Gazebo simulation for full verification workflows.

The explanation does not mention the license, so the terms of use are unknown.

So what is it?

This repository provides a set of skills for Claude Code, an AI coding assistant, to help it work more reliably with ROS 2 Jazzy Jalisco. ROS 2 is a robotics framework used to build robot software, and Jazzy is a specific version of it. The skills are designed to prevent common mistakes that happen when AI generates robotics code. The README is written for developers who already use AI assistants to write robot code and want fewer broken results. The main problem the project addresses is that AI often writes code that looks correct but fails at runtime. For example, a subscriber and publisher might use incompatible communication settings, or the robot moves backward because a coordinate frame is inverted. These issues pass code review and compile without errors, but the robot behaves incorrectly. The skills add a protocol that makes the AI identify missing information, verify assumptions against the installed system, and prove the code actually ran before declaring the task complete. The repository contains 11 skills, a 28-line always-loaded protocol, 32 documentation links checked by continuous integration, 4 physical robot verification scripts, and evaluation results comparing performance with and without the skills. The skills follow a three-step loop: inspect the system, write incremental changes, and confirm execution through observed evidence. The project targets ROS 2 Jazzy on Ubuntu 24.04 only, rather than claiming support for multiple versions. The evaluation section reports results from A/B tests where the same prompt was run with and without the skills in fresh Claude Code sessions. Outputs were checked against pinned upstream sources, a live ROS 2 installation, and a live Gazebo simulation, and then executed against running publishers. Most tests had a sample size of one, which the README acknowledges openly. One task was repeated 13 times and that repetition retracted a conclusion the single run had supported, so the write-up keeps both the claim and the retraction. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1

Using the claude-ros2-skills protocol, write a ROS 2 Jazzy node that subscribes to a laser scan topic and republishes a filtered version, then verify it runs against my live ROS 2 installation.

Prompt 2

Generate a ROS 2 publisher and subscriber pair for custom message types using the three-step inspect-write-confirm loop from claude-ros2-skills, and prove the code executed successfully.

Prompt 3

Inspect my Ubuntu 24.04 ROS 2 Jazzy setup and identify any missing information before writing a tf2 transform broadcaster node, following the claude-ros2-skills protocol.

Prompt 4

Write a ROS 2 action server for robot navigation using claude-ros2-skills, verify the coordinate frames are not inverted, and confirm execution in Gazebo simulation.

Frequently asked questions