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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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는 맵이 아닌 서버 오브젝트 배열 사용.

~/.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와 조합해 10배 효율

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

robotics-agent-skills