/ Diretório / Playground / robotics-agent-skills
● 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.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

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

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "robotics-agent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/arpitg1304/robotics-agent-skills",
        "~/.claude/skills/robotics-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "robotics-agent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/arpitg1304/robotics-agent-skills",
        "~/.claude/skills/robotics-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "robotics-agent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/arpitg1304/robotics-agent-skills",
        "~/.claude/skills/robotics-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "robotics-agent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/arpitg1304/robotics-agent-skills",
        "~/.claude/skills/robotics-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "robotics-agent-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/arpitg1304/robotics-agent-skills",
        "~/.claude/skills/robotics-agent-skills"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "robotics-agent-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/arpitg1304/robotics-agent-skills",
          "~/.claude/skills/robotics-agent-skills"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add robotics-agent-skill -- git clone https://github.com/arpitg1304/robotics-agent-skills ~/.claude/skills/robotics-agent-skills

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

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.

Pré-requisitos
  • Skill installed — git clone https://github.com/arpitg1304/robotics-agent-skills ~/.claude/skills/robotics-agent-skills
  • ROS2 Humble+ on PATH — Follow docs.ros.org install
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