🔧
QualityPython

ROS 2 Troubleshooting

by Leehyunbin0131

ROS 2 Troubleshooting is a Quality skill for Claude Code, published by Leehyunbin0131 in claude-ros2-skills.

18 stars3 forkson Leehyunbin0131/claude-ros2-skillsAdded 2026/08/11Repository updated 2026/08/01
ai-coding-assistantclaude-codeclaude-code-pluginclaude-code-skillsgazebollm-agentsmoveit2nav2roboticsros2ros2-controlros2-jazzy
Install in seconds
Install ROS 2 Troubleshooting
Copy ROS 2 Troubleshooting into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/Leehyunbin0131/claude-ros2-skills/tree/main/skills/ros2-troubleshooting ~/.claude/skills/ros2-troubleshooting

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/Leehyunbin0131/claude-ros2-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/ros2-troubleshooting/SKILL.md in Leehyunbin0131/claude-ros2-skills
Installs to
~/.claude/skills/ros2-troubleshooting
Collection
One of 2 skills cataloged from this repository
Category
Quality1354 skills

What ROS 2 Troubleshooting does

Run four pass/fail diagnostic scripts to troubleshoot ROS 2 Jazzy issues like QoS mismatches, TF frame errors, IMU gravity misalignment, and odometry direction discrepancies. Use when code inspection alone can't pinpoint the fault.

ROS 2 Troubleshooting is cataloged under Quality on DirSkills. ROS 2 Troubleshooting comes from a repository tagged ai-coding-assistant, claude-code, claude-code-plugin, claude-code-skills and gazebo.

Documentation

README

ROS 2 troubleshooting

Most of this skill is scripts that turn a suspicion into an exit code. Run one before reasoning about the symptom.

Bundled checks

scripts/ sits next to this file — resolve the path from this skill's own directory, not the user's CWD. Under a plugin install that is ${CLAUDE_PLUGIN_ROOT}/skills/ros2-troubleshooting/scripts/.

They are plain scripts: invoke with python3 and a real path. There is no package to ros2 run, and inventing one is a known failure mode. Exit code 0 = PASS, 1 = FAIL, 2 = no data. Tell the user the command you ran.

source /opt/ros/jazzy/setup.bash
python3 <this-skill>/scripts/check_qos_compat.py --topic /scan

This is the opening of the README. Read the full README on GitHub.

Commands ROS 2 Troubleshooting provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /scan
  • /odom

Frequently asked about ROS 2 Troubleshooting

  • What else does Leehyunbin0131 publish alongside ROS 2 Troubleshooting?

    ROS 2 Troubleshooting is one of 2 skills that DirSkills catalogs from Leehyunbin0131/claude-ros2-skills, the repository it ships in. Its siblings there include Micro-ROS. Each one is a separate skill with its own page in this directory, installs the same way ROS 2 Troubleshooting does, and is maintained by Leehyunbin0131 in that same repository. The rest of the collection is listed on the Leehyunbin0131/claude-ros2-skills page.

  • How does ROS 2 Troubleshooting compare to other Quality skills?

    ROS 2 Troubleshooting ranks #1336 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of ROS 2 Troubleshooting against them. Open each page to compare what they document and how they install.