/ Annuaire / Playground / robotics-agent-skills
● Communauté arpitg1304 ⚡ Instantané

robotics-agent-skills

par arpitg1304 · arpitg1304/robotics-agent-skills

Skills that make AI coding assistants write production-grade ROS1/ROS2 code — SOLID principles, design patterns, and real tests.

Robotics Agent Skills teaches Claude Code and Cursor the idioms of production robotics: ROS1/ROS2 nodes, topics, services, actions, launch files, testing patterns, and the SOLID principles applied to robotics. Ship code that reviewers won't red-pen because it has proper lifecycle management, logging, and tests.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

robotics-agent-skill.replay ▶ prêt
0/0

Installation

Dépôt de l’auteur · Documentation officielle des Skills Claude

Cas d'usage

Usages concrets : robotics-agent-skills

How to generate a production-ready ROS2 node from a spec

👤 Robotics engineers and students avoiding toy-example code ⏱ ~45 min intermediate

Quand l'utiliser : You're about to write a new node and want clean lifecycle + tests from the start.

Déroulement
  1. Describe the node
    Create a ROS2 Humble node that subscribes to /scan (LaserScan), filters obstacles, and publishes /cmd_vel using a state machine.✓ Copié
    → Node with clear class separation, lifecycle hooks, param declarations
  2. Ask for tests
    Write pytest unit tests for the filter logic and a launch_test for the integration.✓ Copié
    → Tests runnable via colcon test
  3. Package
    Produce package.xml and CMakeLists.txt with correct dependencies.✓ Copié
    → colcon build succeeds

Résultat : A ROS2 package that passes colcon build + test with meaningful coverage.

Pièges
  • Claude mixes ROS1 and ROS2 APIs — State version explicitly in the prompt every time — 'ROS2 Humble'
  • Node lacks shutdown handling — Ask for on_shutdown hooks and SIGTERM cleanup specifically

Migrate a ROS1 package to ROS2

👤 Teams on end-of-life ROS1 Noetic ⏱ ~120 min advanced

Quand l'utiliser : You need to port a working ROS1 package and want more than a mechanical search-replace.

Déroulement
  1. Audit the ROS1 package
    Read this package and list every API we need to remap for ROS2 (params, timers, services, actions).✓ Copié
    → Per-file remap table
  2. Generate ROS2 equivalents
    Produce the ROS2 versions of each file, preserving behavior. Flag anything without a 1:1 mapping.✓ Copié
    → New files + flagged items for human review

Résultat : A ROS2 branch of the package that compiles and passes smoke tests.

Pièges
  • callback_groups and executors missing — Ask Claude to add a MultiThreadedExecutor and assign callback groups based on the old threading model

Add tests to a legacy ROS node without rewriting it

👤 Engineers inheriting an untested node ⏱ ~60 min intermediate

Quand l'utiliser : The node works in the field and you want a safety net before refactoring.

Déroulement
  1. Identify seams
    Look at this node and find the seams where we could inject fakes without changing production behavior.✓ Copié
    → Specific lines/functions to seam
  2. Generate tests at seams
    Write pytest tests using those seams. Don't change the node.✓ Copié
    → Tests that run in isolation and pass

Résultat : A characterization test suite that catches regressions.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

robotics-agent-skill + claude-code-owasp-skill

Security-review ROS networking (rosbridge, Zenoh) using OWASP guidance

Robotics skill produced a rosbridge integration — run OWASP skill against the WebSocket layer.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
ROS2 node generation - New node from scratch 0
ROS1-to-ROS2 migration - Noetic → Humble/Jazzy 0
Launch file authoring - Multi-node orchestration 0
Test scaffolds - Coverage work 0
SOLID + design patterns - Code review and refactor 0

Coût et limites

Coût d'exécution

Quota d'API
None
Tokens par appel
Varies
Monétaire
Free
Astuce
Keep prompts focused on one node at a time; full-package generation balloons tokens fast.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : No credentials
Sortie de données : No outbound calls from the skill itself

Dépannage

Erreurs courantes et correctifs

Generated package fails colcon build with include errors

Claude often forgets to add ament_target_dependencies. Ask to regenerate CMakeLists.txt explicitly.

Vérifier : colcon build --packages-select <pkg>
Tests pass in isolation, fail when run together

Shared ROS context. Ask for per-test rclpy.init() and shutdown().

Vérifier : colcon test

Alternatives

robotics-agent-skills vs autres

AlternativeQuand l'utiliserCompromis
ROS2 official docsYou want canonical patterns not LLM-derivedNo codegen, slower

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills