🤖 Robotics Agent Skills

Production-grade robotics knowledge for AI coding agents.

Drop these SKILL.md files into Claude Code, Autohand Code, Cursor, Copilot-style agents, or custom agent frameworks to make them generate better ROS1/ROS2 software: safer nodes, correct QoS, lifecycle patterns, tests, launch files, Docker, bringup, perception, and security.

Why This Exists

General-purpose coding agents know ROS syntax, but they often miss the robotics details that matter in production: QoS compatibility, deterministic startup, bounded callbacks, sensor health checks, safe shutdown, launch ergonomics, and testability.

This repo is the missing robotics engineering layer for AI coding agents.

Evidence: Same Prompt, With and Without Skills

The evals/ directory compares the same ROS2 package prompt run once with no skills and once with the robotics skills loaded as context.

Result	Without Skills	With Skills
Node architecture	Plain rclpy.Node; setup in constructor	Lifecycle node with configure/activate/deactivate/cleanup/shutdown
Sensor QoS	Default depth 10 for everything	Sensor QoS for camera/joints, reliable QoS for status
Sensor handling	Latest-message assignment	Thread-safe bounded buffers, drop counts, watchdogs
Timestamp sync	None	Sync offset checks and dropped-frame accounting
Tests	0 lines	601 lines
Structure	Single node module	Separate writer module and cleaner responsibilities
Config surface	4 parameters	13 parameters

This is a single-task, single-run comparison, self-assessed, and neither package was built against a real ROS2 distribution — treat it as an illustration of the design decisions the skills push toward, not as a benchmark. Caveats and the known build defects in both artifacts are documented in the report.

Full report: evals/EVAL_REPORT.md

Quick Start

Install selected skills into a project:

git clone https://github.com/arpitg1304/robotics-agent-skills.git
cd robotics-agent-skills
./install.sh --target /path/to/your/robot/.claude/skills --skills ros2 robotics-testing robot-bringup

For Autohand Code project skills:

./install.sh --target /path/to/your/robot/.autohand/skills --skills ros2 robotics-testing robot-bringup

Or copy manually:

cp -R skills/ros2 /path/to/your/robot/.claude/skills/
cp -R skills/robotics-testing /path/to/your/robot/.claude/skills/

Recommended Bundles

Bundle	Skills
ROS2 application	ros2, robotics-software-principles, robotics-testing, robot-bringup
Robot perception	ros2, robot-perception, robotics-testing, docker-ros2-development
Production robot	ros2, robot-bringup, robotics-security, robotics-testing
Web dashboard	ros2, ros2-web-integration, robotics-security, robot-bringup
ROS1 maintenance	ros1, robotics-software-principles, robotics-testing

Skills