Skip to content
Back to search

robotics-agent-skills

Agent skills that make AI coding assistants write production-grade robotics software. ROS1, ROS2, design patterns, SOLID principles, and testing — for Claude Code, Cursor, Copilot, and any SKILL.md-compatible agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/arpitg1304--robotics-agent-skills/badge.svg)](/listings/arpitg1304--robotics-agent-skills)

HTML

<a href="/listings/arpitg1304--robotics-agent-skills"><img src="/api/listings/arpitg1304--robotics-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 175 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🤖 Robotics Agent Skills
  2. Production-grade robotics knowledge for AI coding agents.
  3. Drop these `SKILL.md` files into Claude Code, Autohand Code, Cursor, Copilot-style
  4. agents, or custom agent frameworks to make them generate better ROS1/ROS2 software:
  5. safer nodes, correct QoS, lifecycle patterns, tests, launch files, Docker, bringup,
  6. perception, and security.
  7. [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
  8. ![Skills](https://img.shields.io/badge/skills-10-green)
  9. ![ROS](https://img.shields.io/badge/ROS1%20%2B%20ROS2-supported-orange)
  10. ![Agent Format](https://img.shields.io/badge/format-SKILL.md-purple)
  11. ## Why This Exists
  12. General-purpose coding agents know ROS syntax, but they often miss the robotics details
  13. that matter in production: QoS compatibility, deterministic startup, bounded callbacks,
  14. sensor health checks, safe shutdown, launch ergonomics, and testability.
  15. This repo is the missing robotics engineering layer for AI coding agents.
  16. ## Evidence: Same Prompt, With and Without Skills
  17. The `evals/` directory compares the same ROS2 package prompt run once with no skills and
  18. once with the robotics skills loaded as context.
  19. | Result | Without Skills | With Skills |
  20. |--------|----------------|-------------|
  21. | Node architecture | Plain `rclpy.Node`; setup in constructor | Lifecycle node with configure/activate/deactivate/cleanup/shutdown |
  22. | Sensor QoS | Default depth 10 for everything | Sensor QoS for camera/joints, reliable QoS for status |
  23. | Sensor handling | Latest-message assignment | Thread-safe bounded buffers, drop counts, watchdogs |
  24. | Timestamp sync | None | Sync offset checks and dropped-frame accounting |
  25. | Tests | 0 lines | 601 lines |
  26. | Structure | Single node module | Separate writer module and cleaner responsibilities |
  27. | Config surface | 4 parameters | 13 parameters |
  28. This is a single-task, single-run comparison, self-assessed, and neither package was
  29. built against a real ROS2 distribution — treat it as an illustration of the design
  30. decisions the skills push toward, not as a benchmark. Caveats and the known build
  31. defects in both artifacts are documented in the report.
  32. Full report: [evals/EVAL_REPORT.md](evals/EVAL_REPORT.md)
  33. ## Quick Start
  34. Install selected skills into a project:
  35. ```bash
  36. git clone https://github.com/arpitg1304/robotics-agent-skills.git
  37. cd robotics-agent-skills
  38. ./install.sh --target /path/to/your/robot/.claude/skills --skills ros2 robotics-testing robot-bringup
  39. ```
  40. For Autohand Code project skills:
  41. ```bash
  42. ./install.sh --target /path/to/your/robot/.autohand/skills --skills ros2 robotics-testing robot-bringup
  43. ```
  44. Or copy manually:
  45. ```bash
  46. cp -R skills/ros2 /path/to/your/robot/.claude/skills/
  47. cp -R skills/robotics-testing /path/to/your/robot/.claude/skills/
  48. ```
  49. ## Recommended Bundles
  50. | Bundle | Skills |
  51. |--------|--------|
  52. | ROS2 application | `ros2`, `robotics-software-principles`, `robotics-testing`, `robot-bringup` |
  53. | Robot perception | `ros2`, `robot-perception`, `robotics-testing`, `docker-ros2-development` |
  54. | Production robot | `ros2`, `robot-bringup`, `robotics-security`, `robotics-testing` |
  55. | Web dashboard | `ros2`, `ros2-web-integration`, `robotics-security`, `robot-bringup` |
  56. | ROS1 maintenance | `ros1`, `robotics-software-principles`, `robotics-testing` |
  57. ## Skills
  58. | Skill | Description | Key Topics |
  59. |-------|-------------|------------|
  60. | [robotics-software-principles](skills/robotics-software-principles/SKILL.md) | Design principles | SOLID for robotics, fail-safe defaults, rate separation, composability, graceful degradation |
  61. | [ros1](skills/ros1/SKILL.md) | ROS1 development | catkin, rospy, roscpp, nodelets, tf, actionlib, launch XML, migration |
  62. | [ros2](skills/ros2/SKILL.md) | ROS2 development | rclpy, rclcpp, DDS, QoS, lifecycle nodes, components, Python launch |
  63. | [robotics-design-patterns](skills/robotics-design-patterns/SKILL.md) | Architecture patterns | Behavior trees, FSMs, HAL, safety systems, sensor fusion, sim-to-real |
  64. | [robot-perception](skills/robot-perception/SKILL.md) | Perception systems | Cameras, LiDAR, depth, calibration, point clouds, detection, tracking, sensor fusion |
  65. | [robotics-testing](skills/robotics-testing/SKILL.md) | Testing strategies | pytest + ROS, launch_testing, mock hardware, golden files, CI/CD |
  66. | [docker-ros2-development](skills/docker-ros2-development/SKILL.md) | Docker + ROS2 | Multi-stage Dockerfiles, compose, DDS across containers, GPU passthrough, devcontainers |
  67. | [ros2-web-integration](skills/ros2-web-integration/SKILL.md) | Web integration | rosbridge, FastAPI/Flask bridges, WebSocket streaming, REST APIs, MJPEG/WebRTC, security |
  68. | [robot-bringup](skills/robot-bringup/SKILL.md) | System bringup | systemd services, launch composition, udev rules, watchdogs, log rotation, graceful shutdown |
  69. | [robotics-security](skills/robotics-security/SKILL.md) | Security and hardening | SROS2, DDS encryption, network segmentation, secrets management, e-stop isolation, secure boot |
  70. ## How Agents Use These Skills
  71. ### Claude Code
  72. Copy or symlink the skills you need into your project's `.claude/skills/` directory.
  73. Claude Code auto-discovers `SKILL.md` files and triggers them based on the YAML
  74. `description` field.
  75. ### Autohand Code
  76. Copy or symlink the skills you need into your project's `.autohand/skills/`
  77. directory. User-level skills live under `~/.autohand/skills/`; project-level
  78. skills live under `<project>/.autohand/skills/`.
  79. ### Claude Projects
  80. Place the skill directories in your project's `/mnt/skills/user/` directory.
  81. ### Custom Agent Frameworks
  82. Load the relevant `SKILL.md` as system-prompt context when a task matches the skill:
  83. ```python
  84. from pathlib import Path
  85. SKILLS = {
  86. "ros2": "skills/ros2/SKILL.md",
  87. "testing": "skills/robotics-testing/SKILL.md",
  88. "perception": "skills/robot-perception/SKILL.md",
  89. "bringup": "skills/robot-bringup/SKILL.md",
  90. "security": "skills/robotics-security/SKILL.md",
  91. }
  92. def load_skill(task_description: str) -> str:
  93. text = task_description.lower()
  94. for trigger, path in SKILLS.items():
  95. if trigger in text:
  96. return Path(path).read_text()
  97. return ""
  98. ```
  99. ## What Good Skills Contain
  100. - Specific trigger descriptions so agents know when to load them.
  101. - Working examples, not just prose.
  102. - Robotics failure modes: QoS mismatches, stale transforms, unsafe shutdown, blocking callbacks.
  103. - Production defaults: bounded queues, lifecycle management, observability, tests.
  104. - Anti-patterns that show what to avoid.
  105. ## Coverage Map
  106. ```text
  107. Robot System Architecture
  108. ├── Design Principles ---- robotics-software-principles/ (SOLID, safety, composability)
  109. ├── Middleware ----------- ros1/, ros2/
  110. ├── Behaviors ----------- robotics-design-patterns/ (BT, FSM)
  111. ├── Perception ---------- robot-perception/ (cameras, LiDAR, depth, calibration, fusion)
  112. ├── Planning ------------ robotics-design-patterns/ (motion planning)
  113. ├── Control ------------- robotics-design-patterns/ (control loops)
  114. ├── Safety -------------- robotics-design-patterns/ (watchdogs, limits)
  115. ├── Testing ------------- robotics-testing/ (unit, integration, sim)
  116. ├── Containerization ---- docker-ros2-development/ (Dockerfiles, compose, DDS, GPU)
  117. ├── Web Interfaces ------ ros2-web-integration/ (REST, WebSocket, streaming, dashboards)
  118. ├── System Bringup ------ robot-bringup/ (systemd, udev, watchdogs, boot sequence)
  119. ├── Security ------------ robotics-security/ (SROS2, hardening, e-stop isolation)
  120. └── Deployment ---------- ros2/ (production checklist, CI/CD)
  121. ```
  122. ## Roadmap
  123. High-impact skills to add next:
  124. - `robot-navigation/` - Nav2, SLAM, localization, costmaps, planners, recovery behaviors.
  125. - `robot-manipulation/` - MoveIt2, grasp planning, planning scenes, TF, pick-and-place.
  126. - `ros2-control/` - hardware interfaces, controllers, update loops, real-time pitfalls.
  127. - `robot-simulation/` - Gazebo, Isaac Sim, MuJoCo, sim clock, resets, domain randomization.
  128. - `robot-description/` - URDF, Xacro, inertials, collision meshes, robot_state_publisher.
  129. - `robot-debugging/` - ros2 doctor, rqt, tracing, rosbag replay, diagnostics.
  130. - `robotics-data-pipelines/` - RLDS, LeRobot, Zarr, dataset curation, format conversion.
  131. - `multi-robot-systems/` - namespaces, fleets, DDS partitions, task allocation.
  132. Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for the skill format
  133. and review checklist.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.