TopicForge

    1

    Read-only ROS 2 graph inspection, DDS diagnostics, and bag file analysis via MCP.

    Free

    1 useSecurity scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    About this skill

    Debugging a ROS 2 system often feels like shouting into a void when topics go silent or nodes fail to communicate. TopicForge provides a read-only inspection layer for live ROS 2 graphs, DDS buses, and recorded bags without the risk of accidentally commanding the robot.

    What it does

    • Live Graph Inspection lists topics, types, and counts while identifying node duplicates and blocked executors.
    • Message Sampling captures live data with configurable timeouts and array truncation to handle high-bandwidth sensors.
    • Deep Node Analysis retrieves service, action, and parameter listings, including specific QoS profiles for reliability and durability.
    • Bag File Analysis extracts duration, frequency statistics, and per-topic counts from MCAP, SQLite3, and ROS 1 files.
    • DDS Bus Diagnostics identifies endpoints and connectivity issues even when the standard ROS 2 CLI backend is unavailable.

    How it works

    1. Health Check runs to determine if the agent is connected to a live robot, a mock environment, or a raw DDS bus.
    2. Discovery uses list_topics and list_nodes to map the active communication graph and identify stakeholders.
    3. Deep Dive invokes get_topic_info or get_node_info to pinpoint QoS mismatches or unresponsive parameters.
    4. Data Validation employs sample_messages or peek_bag_samples to verify the actual content flowing through the pipes.

    Frameworks & tools

    Built for ROS 2 (Humble, Iron, Jazzy) using the TopicForge MCP server. Supports MCAP, db3, and legacy .bag formats via the rosbags library. Compatible with CycloneDDS and other RMW implementations.

    Why this beats prompting it yourself

    Standard LLMs cannot see your local robot's middleware or parse binary bag files. This skill provides the specific tools to bridge the gap between the agent and the live ROS 2 computational graph with built-in safety constraints.

    Use cases

    • Diagnose why two nodes are failing to communicate due to QoS durability mismatches.
    • Audit a recorded MCAP bag file to find missing frames or unexpected message drops.
    • Inspect live sensor data like LaserScan or Image streams without crashing the agent with large arrays.
    • Identify blocked node executors by detecting timeouts during parameter retrieval.

    Known limitations

    Read-only by design; cannot publish messages or call services. Requires the TopicForge MCP server and a local ROS 2 installation for live graph access.

    Read-only access only. Requires local ROS 2 installation or TopicForge MCP server setup. Large message types like PointCloud2 require explicit array length configuration to avoid truncation.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 26 days ago

    • Free with an Agensi account

    Requires

    Python

    Permissions

    Network Access
    Listed26 days ago

    What's inside

    Frequently Asked Questions

    TopicForge allows an AI agent to see your live robot's internal communication, diagnosing issues like QoS mismatches and blocked executors that standard LLMs cannot detect. It provides a safe, read-only window into ROS 2 graphs and DDS buses to pinpoint why nodes aren't talking.

    The skill is compatible with ROS 2 Humble, Iron, and Jazzy distributions. It supports various RMW implementations like CycloneDDS and FastDDS, and can parse MCAP, SQLite3 (db3), and legacy ROS 1 bag files.

    No, TopicForge is strictly read-only by design to ensure robot safety. It can inspect topics, sample messages, and audit parameters, but it cannot publish commands, call services, or modify the state of your robot.

    You will need a local ROS 2 installation and the TopicForge MCP server running on the machine connected to your robot or bag files. The AI agent connects to this server to execute the diagnostic tools provided in the skill.

    To prevent high-bandwidth sensors (like LiDAR or Cameras) from crashing the agent's context, the skill includes built-in array truncation and configurable sampling timeouts. This ensures you see the data you need without overwhelming the AI with massive binary streams.

    New in APIs & Backend

    Free