robotics-agent-skills

왜 쓰나요

핵심 기능

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

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: 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.

흐름

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

대안