robotics-agent-skills MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

ROS1 and ROS2 coverage, including launch files and package.xml
SOLID principles applied to robotics code
Common design patterns (State, Observer, Strategy) in ROS context
Testing scaffolds: pytest, rostest, gtest
Node lifecycle patterns (managed/unmanaged)
Cross-agent: works with any SKILL.md-compatible assistant

Живое демо

Как выглядит на практике

robotics-agent-skill.replay ▶ готово

0/0

Установка

Выберите клиент

~/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
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

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

Continue использует массив объектов серверов, а не 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"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: 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

Когда использовать: You're about to write a new node and want clean lifecycle + tests from the start.

Предварительные требования

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

Поток

Describe the node

Create a ROS2 Humble node that subscribes to /scan (LaserScan), filters obstacles, and publishes /cmd_vel using a state machine.✓ Скопировано

→ Node with clear class separation, lifecycle hooks, param declarations
Ask for tests

Write pytest unit tests for the filter logic and a launch_test for the integration.✓ Скопировано

→ Tests runnable via colcon test
Package

Produce package.xml and CMakeLists.txt with correct dependencies.✓ Скопировано

→ colcon build succeeds

Итог: A ROS2 package that passes colcon build + test with meaningful coverage.

Подводные камни

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

Когда использовать: You need to port a working ROS1 package and want more than a mechanical search-replace.

Поток

Audit the ROS1 package

Read this package and list every API we need to remap for ROS2 (params, timers, services, actions).✓ Скопировано

→ Per-file remap table
Generate ROS2 equivalents

Produce the ROS2 versions of each file, preserving behavior. Flag anything without a 1:1 mapping.✓ Скопировано

→ New files + flagged items for human review

Итог: A ROS2 branch of the package that compiles and passes smoke tests.

Подводные камни

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

Когда использовать: The node works in the field and you want a safety net before refactoring.

Поток

Identify seams

Look at this node and find the seams where we could inject fakes without changing production behavior.✓ Скопировано

→ Specific lines/functions to seam
Generate tests at seams

Write pytest tests using those seams. Don't change the node.✓ Скопировано

→ Tests that run in isolation and pass

Итог: A characterization test suite that catches regressions.

Комбинации

Сочетайте с другими MCP — эффект 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.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать
ROS2 node generation	-	New node from scratch
ROS1-to-ROS2 migration	-	Noetic → Humble/Jazzy
Launch file authoring	-	Multi-node orchestration
Test scaffolds	-	Coverage work
SOLID + design patterns	-	Code review and refactor

Стоимость и лимиты

Во что обходится

Квота API: None
Токенов на вызов: Varies
Деньги: Free
Совет: Keep prompts focused on one node at a time; full-package generation balloons tokens fast.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: No credentials

Исходящий трафик: No outbound calls from the skill itself

Robotics code can move physical hardware. Always run Claude-generated nodes in sim first.

Устранение неполадок

Частые ошибки и исправления

Generated package fails colcon build with include errors

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

Проверить: colcon build --packages-select <pkg>

Tests pass in isolation, fail when run together

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

Проверить: colcon test

Альтернативы

robotics-agent-skills в сравнении

Альтернатива	Когда использовать	Компромисс
ROS2 official docs	You want canonical patterns not LLM-derived	No codegen, slower

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills