← Back to Skills Marketplace
ROS2 Introspection
by
Brian Robinson
· GitHub ↗
· v1.0.1
· MIT-0
116
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install ros2-introspection
Description
Execute core ROS 2 introspection commands to query the ROS graph (topics, nodes, services, actions, parameters). STRICTLY read-only.
Usage Guidance
This skill appears to do exactly what it claims: run read-only ROS 2 introspection commands. Before installing or invoking it, 1) run the provided scripts locally and inspect them (they are short and readable); 2) run setup.sh yourself to confirm the ros_setup_path it writes; 3) be cautious when running commands like 'topic echo' or 'param dump' since they can display or stream topic/parameter values that may contain sensitive robot data; 4) note that 'rqt_graph' is executed as a special case (it will launch a GUI) and is not passed through the same validation flow — if you don't want GUIs launched, avoid that subcommand; and 5) run the skill in an environment you control (or a container) if you have sensitive topics or networks. Overall the package is internally consistent and low-risk provided you follow these precautions.
Capability Analysis
Type: OpenClaw Skill
Name: ros2-introspection
Version: 1.0.1
The skill provides a well-structured and security-conscious interface for ROS 2 introspection. It implements a Python wrapper (safe_ros2_introspection.py) that enforces a strict allowlist of read-only commands and utilizes safe subprocess execution (shell=False) to mitigate command injection risks. The setup script (setup.sh) and configuration logic are transparent and align with standard ROS 2 environment requirements without any indicators of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
Name/description (read-only ROS 2 introspection) matches the provided scripts and README: the wrapper runs 'ros2' introspection subcommands and setup.sh records the path to the ROS setup.bash. There are no unrelated credentials, cloud APIs, or extraneous binaries requested.
Instruction Scope
SKILL.md confines operations to read-only introspection and instructs using the safe wrapper. The wrapper enforce an allowlist for most commands. Minor caveats: (1) 'rqt_graph' is handled as a special case and is executed without going through the same allowlist/environment setup; (2) 'ros2 topic echo' and similar read operations can stream topic data (which may be sensitive) and may block or produce large outputs. These behaviors are consistent with legitimate introspection but worth awareness.
Install Mechanism
No install spec; only local scripts are included. The setup script writes a local config.json in the skill directory. No external downloads or extracted archives are performed.
Credentials
The skill requests no external credentials or environment variables. It does source the user's ROS setup.bash (necessary to run ros2 commands) and constructs an environment from that file — this is proportional to the stated purpose. The only stored config is the local ros_setup_path.
Persistence & Privilege
always is false and the skill does not request permanent system-wide privileges. The only persistent change is a config/config.json file inside the skill directory (written by setup.sh), which is reasonable for local configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ros2-introspection - After installation, invoke the skill by name or use
/ros2-introspection - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Replaced the shell script wrapper with a Python script: `safe_ros2_introspection.py` (improves command validation and security).
- Removed `safe_ros2_introspection.sh`; all commands now routed through the new Python wrapper.
- Documentation updated to reflect the new usage and allowed command patterns.
- Strict read-only security and command allowlisting are enforced in the Python script.
v1.0.0
Initial release of ros2-introspection skill.
- Provides a secure, strictly read-only interface for ROS 2 graph introspection using a safe wrapper script.
- Supports listing and querying ROS topics, nodes, services, actions, and parameters.
- Enforces use of the allowlisted `safe_ros2_introspection.sh` script to prevent modification or accidental execution.
- Includes detailed setup and usage instructions for proper environment configuration.
Metadata
Frequently Asked Questions
What is ROS2 Introspection?
Execute core ROS 2 introspection commands to query the ROS graph (topics, nodes, services, actions, parameters). STRICTLY read-only. It is an AI Agent Skill for Claude Code / OpenClaw, with 116 downloads so far.
How do I install ROS2 Introspection?
Run "/install ros2-introspection" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ROS2 Introspection free?
Yes, ROS2 Introspection is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ROS2 Introspection support?
ROS2 Introspection is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ROS2 Introspection?
It is built and maintained by Brian Robinson (@bigrobinson); the current version is v1.0.1.
More Skills