ROS2 Introspection

v1.0.1

Execute core ROS 2 introspection commands to query the ROS graph (topics, nodes, services, actions, parameters). STRICTLY read-only.

0· 107·0 current·0 all-time
byBrian Robinson@bigrobinson

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for bigrobinson/ros2-introspection.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "ROS2 Introspection" (bigrobinson/ros2-introspection) from ClawHub.
Skill page: https://clawhub.ai/bigrobinson/ros2-introspection
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install ros2-introspection

ClawHub CLI

Package manager switcher

npx clawhub@latest install ros2-introspection
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
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.
Assessment
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.

Like a lobster shell, security has layers — review code before you run it.

latestvk9703eccftgxrsme2zh78weahs84dtbw
107downloads
0stars
2versions
Updated 2w ago
v1.0.1
MIT-0

ROS 2 Introspection (Sandboxed)

Setup & Installation

Before this skill can be used, the local environment must be configured.

  1. Source your environment: You MUST source your ROS 2 environment first in your terminal.
    source /opt/ros/<distro>/setup.bash
    
  2. Run setup:
    ./scripts/setup.sh
    

Overview

Use this skill to inspect the ROS 2 graph. It is STRICTLY read-only. You cannot use this skill to run nodes, call services, or send action goals (use ros2-execution for that).

SECURITY CONSTRAINT: You must ALWAYS use the safe wrapper script located at ./scripts/safe_ros2_introspection.py. This Python script uses subprocess (shell=False) to prevent command injection and validates the command against a strict allowlist.

Wrapper Path: Resolve ./scripts/safe_ros2_introspection.py against this SKILL.md directory.

Allowed Commands

Usage: ./scripts/safe_ros2_introspection.py <category> <subcmd> [args]

  • Topics:
    • ./scripts/safe_ros2_introspection.py topic list
    • ./scripts/safe_ros2_introspection.py topic info <topic>
    • ./scripts/safe_ros2_introspection.py topic echo <topic>
    • ./scripts/safe_ros2_introspection.py topic hz <topic>
    • ./scripts/safe_ros2_introspection.py topic bw <topic>
  • Nodes:
    • ./scripts/safe_ros2_introspection.py node list
    • ./scripts/safe_ros2_introspection.py node info <node>
  • Services:
    • ./scripts/safe_ros2_introspection.py service list
    • ./scripts/safe_ros2_introspection.py service type <srv>
    • ./scripts/safe_ros2_introspection.py service find <type>
  • Actions:
    • ./scripts/safe_ros2_introspection.py action list
    • ./scripts/safe_ros2_introspection.py action info <action>
  • Parameters:
    • ./scripts/safe_ros2_introspection.py param list
    • ./scripts/safe_ros2_introspection.py param get <node> <param>
    • ./scripts/safe_ros2_introspection.py param dump <node>
  • Interfaces:
    • ./scripts/safe_ros2_introspection.py interface show <type>
  • RQT:
    • ./scripts/safe_ros2_introspection.py rqt_graph

Comments

Loading comments...