ROS Control Architecture & Debugging
Design, debug, and optimize ROS control architectures for robotic systems
What You Can Do
You can architect multi-node ROS control systems from scratch, including node design patterns, communication flows, and real-time constraints. You'll debug complex node interactions using publisher/subscriber analysis, service call tracing, and action server diagnostics. You can optimize motion controllers through PID tuning, trajectory planning validation, and performance profiling to achieve precise, responsive robotic behavior.
Features
Create scalable node hierarchies with clear separation of concerns and optimal message routing
Analyze pub/sub topics, service calls, and action servers to identify bottlenecks and latency sources
Tune PID gains, validate trajectories, and profile real-time loop performance
Design and validate transform hierarchies for multi-body kinematics and sensor fusion
Generate comprehensive test plans that verify node interactions and system behavior under load
Document and validate ROS parameter configurations across different hardware setups
Set up realistic simulation environments (Gazebo, RVIZ) that match real robot hardware
Identify CPU bottlenecks and latency sources using rosbag analysis and timing instrumentation
Example Output
Example 1: Node Architecture Design
Proposed Architecture:
- /motor_controller node (C++) — handles PWM output, 100Hz control loop
- /feedback_aggregator node (Python) — fuses encoder + IMU sensor data
- /trajectory_planner node (C++) — generates smooth velocity profiles
- /system_monitor node (Python) — logs performance metrics and diagnostics
Communication Graph:
- trajectory_planner → /cmd_velocity → motor_controller
- feedback_aggregator → /sensor_fusion → system_monitor
- All nodes call /get_status service on motor_controller for health checks
Example 2: PID Tuning Analysis
Current Performance: 28% overshoot, 850ms settling time
Root Cause: Kd too low, inadequate damping
Proposed Gains:
Kp: 2.5 (↑ from 2.0) — increase step response speed
Ki: 0.12 (↓ from 0.15) — reduce oscillation
Kd: 1.2 (↑ from 0.5) — improve damping ratio
Expected Result: <5% overshoot, 300ms settling time
Validation: Run step response test with 100 iterations
Example 3: Latency Debug Report
- ⚠️ Problem: 120ms latency spike every 4 seconds
Analysis: feedback_aggregator blocks on I2C read (contention with other threads)
Solution: Move sensor read to dedicated callback thread with timeout
Test: Capture 60 seconds of data, verify max latency <40ms
✓ Expected improvement: Consistent <50ms end-to-end latency
What's Included
- SKILL.md: Complete ROS control architecture framework with decision trees and step-by-step workflows
- Node design templates: Starter code for C++ and Python node types (publishers, subscribers, services, actions)
- Debugging checklists: Topic connectivity verification, service availability testing, frame transform validation
- PID tuning workflow: Systematic gain selection methodology with validation procedures
- tf configuration guide: Best practices for transform tree design, singularity detection, and coordinate frame validation
- Integration test templates: Example pytest and rostest scenarios for multi-node system verification
- Performance profiling guide: rosbag analysis techniques, rqt_graph interpretation, and CPU bottleneck identification
Who It's For
- Robotics software engineers — designing and maintaining distributed control systems
- Control systems engineers — optimizing motion performance and stability
- ROS middleware developers — debugging multi-node interactions and communication flows
- Autonomous vehicle developers — architecting real-time control stacks with strict timing requirements
- Manufacturing automation specialists — integrating multi-axis controllers with industrial robots
Best For
- Designing multi-node ROS control systems from architecture through deployment and testing
- Debugging communication bottlenecks and latency issues in distributed robotics systems
- Optimizing motor control loops and trajectory planning performance
- Setting up and validating tf (transform) frame hierarchies for complex kinematic chains
- Integrating custom motion controllers with ROS hardware interfaces and middleware
You might also like
You can accelerate your entire antenna design workflow—from initial concept to optimized specifications—by leveraging Claude's knowledge of electromagnetic theory, antenna types, and design trade-offs. Claude helps you parameterize designs, identify optimal configurations for your frequency band and application, and prepare detailed briefs for simulation and manufacturing. You'll generate design reviews, impedance-matching solutions, and validation checklists without context-switching to multiple tools.
You can convert raw API code, OpenAPI specs, GraphQL schemas, and implementation details into production-ready reference documentation. The skill generates systematically organized endpoint documentation with parameter tables, real request/response examples, error code catalogs, authentication details, rate limits, and SDK usage snippets in multiple programming languages—creating the authoritative developer reference for REST APIs, GraphQL APIs, WebSocket APIs, and webhook schemas.
Rapidly analyze production incidents by correlating observability signals—logs, metrics, traces, and events—to identify the true root cause instead of symptoms. You'll reconstruct incident timelines, quantify impact scope, and generate both immediate remediation steps and long-term prevention measures.
This skill guides you through designing Kalman filters for your specific state estimation and sensor fusion problems. You'll learn to diagnose filter divergence, tune covariance matrices (Q and R), and validate observability—turning mathematical theory into production-ready filters. The skill provides step-by-step workflows, diagnostic tools, and practical templates for common applications like GPS/IMU fusion, SLAM, and aircraft navigation.
Claude analyzes your code diffs and generates standardized commit messages that follow the Conventional Commits specification. The skill automatically determines the correct commit type, scope, and description based on the changes you've made, ensuring your messages are parseable by automation tools while remaining human-readable for code reviewers.
You'll transform high-level feature requirements into a complete development plan covering API design, frontend implementation, testing strategy, and documentation. The skill helps you identify dependencies, parallelize work across frontend and backend teams, and establish quality gates that ensure features ship bug-free with proper error handling and logging.
You get a comprehensive security and gas optimization review of your Solidity smart contracts. The skill identifies common vulnerabilities like reentrancy attacks, overflow/underflow bugs, and unchecked external calls, while also pinpointing expensive operations and suggesting specific gas optimizations. Use this as a pre-audit screening to catch issues early and prepare your code for professional security review.
You can rapidly design, optimize, and validate chromatographic and LC-MS/MS methods for analyzing drugs and metabolites in biological matrices. This skill guides you through analytical method development workflows—including parameter selection, sensitivity optimization, and regulatory strategy—while ensuring ICH Q2(R2) and FDA compliance throughout the development process.