/ Directorio / Playground / robotics-agent-skills
← Todos los servidores ↗ GitHub
● Comunidad arpitg1304 ⚡ Instantáneo

robotics-agent-skills

por arpitg1304 · arpitg1304/robotics-agent-skills

Habilidades que permiten a los asistentes de IA para codificación escribir código ROS1/ROS2 de calidad de producción — principios SOLID, patrones de diseño y pruebas reales.

Robotics Agent Skills enseña a Claude Code y Cursor los modismos de la robótica de producción: nodos ROS1/ROS2, temas, servicios, acciones, archivos launch, patrones de prueba y los principios SOLID aplicados a la robótica. Entrega código que los revisores no van a necesitar cambiar porque tiene gestión adecuada del ciclo de vida, registro y pruebas.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

robotics-agent-skill.replay ▶ listo
0/0

Instalación

Repositorio del autor · Documentación oficial de Skills de Claude

Casos de uso

Usos del mundo real: robotics-agent-skills

Cómo generar un nodo ROS2 listo para producción a partir de una especificación

👤 Ingenieros de robótica y estudiantes que evitan código de ejemplos juguete ⏱ ~45 min intermediate

Cuándo usarlo: Estás a punto de escribir un nodo nuevo y quieres ciclo de vida limpio + pruebas desde el inicio.

Flujo
  1. Describe el nodo
    Crea un nodo ROS2 Humble que se suscriba a /scan (LaserScan), filtre obstáculos y publique /cmd_vel usando una máquina de estados.✓ Copiado
    → Nodo con separación clara de clases, hooks de ciclo de vida, declaraciones de parámetros
  2. Pide pruebas
    Escribe pruebas unitarias pytest para la lógica del filtro y una launch_test para la integración.✓ Copiado
    → Pruebas ejecutables mediante colcon test
  3. Empaqueta
    Produce package.xml y CMakeLists.txt con dependencias correctas.✓ Copiado
    → colcon build tiene éxito

Resultado: Un paquete ROS2 que pase colcon build + test con cobertura significativa.

Errores comunes
  • Claude mezcla APIs de ROS1 y ROS2 — Especifica la versión explícitamente en el prompt cada vez — 'ROS2 Humble'
  • El nodo carece de manejo de apagado — Pide hooks on_shutdown y limpieza de SIGTERM específicamente

Migra un paquete ROS1 a ROS2

👤 Equipos en ROS1 Noetic al final de su vida útil ⏱ ~120 min advanced

Cuándo usarlo: Necesitas portar un paquete ROS1 que funcione y quieres algo más que una búsqueda y reemplazo mecánica.

Flujo
  1. Audita el paquete ROS1
    Lee este paquete y lista cada API que necesitamos remapear para ROS2 (parámetros, temporizadores, servicios, acciones).✓ Copiado
    → Tabla de remapeo por archivo
  2. Genera equivalentes ROS2
    Produce las versiones ROS2 de cada archivo, preservando el comportamiento. Marca cualquier cosa sin mapeo 1:1.✓ Copiado
    → Archivos nuevos + elementos marcados para revisión humana

Resultado: Una rama ROS2 del paquete que se compile y pase pruebas de humo.

Errores comunes
  • callback_groups y ejecutores faltantes — Pide a Claude que agregue un MultiThreadedExecutor y asigne grupos de callback basándose en el modelo de subprocesamiento anterior

Agrega pruebas a un nodo ROS heredado sin reescribirlo

👤 Ingenieros que heredan un nodo sin pruebas ⏱ ~60 min intermediate

Cuándo usarlo: El nodo funciona en el campo y quieres una red de seguridad antes de refactorizar.

Flujo
  1. Identifica costuras
    Mira este nodo y encuentra las costuras donde podríamos inyectar falsificaciones sin cambiar el comportamiento de producción.✓ Copiado
    → Líneas/funciones específicas para costurar
  2. Genera pruebas en costuras
    Escribe pruebas pytest usando esas costuras. No cambies el nodo.✓ Copiado
    → Pruebas que se ejecutan aisladamente y pasan

Resultado: Un conjunto de pruebas de caracterización que detecte regresiones.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

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

Revisión de seguridad de redes ROS (rosbridge, Zenoh) usando orientación OWASP

La skill de Robótica produjo una integración rosbridge — ejecuta la skill OWASP contra la capa WebSocket.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
ROS2 node generation - Nodo nuevo desde cero 0
ROS1-to-ROS2 migration - Noetic → Humble/Jazzy 0
Launch file authoring - Orquestación de múltiples nodos 0
Test scaffolds - Trabajo de cobertura 0
SOLID + design patterns - Revisión de código y refactorización 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno
Tokens por llamada
Varía
Monetario
Gratuito
Consejo
Mantén los prompts enfocados en un nodo a la vez; la generación completa del paquete infla los tokens rápidamente.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales
Salida de datos: Sin llamadas salientes de la skill en sí

Resolución de problemas

Errores comunes y soluciones

El paquete generado falla en colcon build con errores de inclusión

Claude a menudo olvida agregar ament_target_dependencies. Pide regenerar CMakeLists.txt explícitamente.

Verificar: colcon build --packages-select <pkg>
Las pruebas pasan aisladamente, fallan cuando se ejecutan juntas

Contexto ROS compartido. Pide rclpy.init() y shutdown() por prueba.

Verificar: colcon test

Alternativas

robotics-agent-skills vs otros

AlternativaCuándo usarlaContrapartida
Documentación oficial de ROS2Quieres patrones canónicos no derivados de LLMSin generación de código, más lento

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills