/ Diretório / Playground / robotics-agent-skills
← Todos os servidores ↗ GitHub
● Comunidade arpitg1304 ⚡ Instantâneo

robotics-agent-skills

por 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.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

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

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: 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

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

Fluxo
  1. Describe the node
    Create a ROS2 Humble node that subscribes to /scan (LaserScan), filters obstacles, and publishes /cmd_vel using a state machine.✓ Copiado
    → 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.✓ Copiado
    → Tests runnable via colcon test
  3. Package
    Produce package.xml and CMakeLists.txt with correct dependencies.✓ Copiado
    → colcon build succeeds

Resultado: A ROS2 package that passes colcon build + test with meaningful coverage.

Armadilhas
  • 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

Quando usar: You need to port a working ROS1 package and want more than a mechanical search-replace.

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

Resultado: A ROS2 branch of the package that compiles and passes smoke tests.

Armadilhas
  • 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

Quando usar: The node works in the field and you want a safety net before refactoring.

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

Resultado: A characterization test suite that catches regressions.

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
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

Custo e limites

O que custa rodar

Cota de API
None
Tokens por chamada
Varies
Monetário
Free
Dica
Keep prompts focused on one node at a time; full-package generation balloons tokens fast.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials
Saída de dados: No outbound calls from the skill itself

Solução de problemas

Erros comuns e correções

Generated package fails colcon build with include errors

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

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

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

Verificar: colcon test

Alternativas

robotics-agent-skills vs. outros

AlternativaQuando usarTroca
ROS2 official docsYou want canonical patterns not LLM-derivedNo codegen, slower

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills