/ ディレクトリ / プレイグラウンド / robotics-agent-skills
← 全サーバー ↗ GitHub
● コミュニティ arpitg1304 ⚡ 即起動

robotics-agent-skills

作者 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.

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

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.

フロー
  1. 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
  2. Ask for tests
    Write pytest unit tests for the filter logic and a launch_test for the integration.✓ コピーしました
    → Tests runnable via colcon test
  3. 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.

フロー
  1. 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
  2. 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.

フロー
  1. Identify seams
    Look at this node and find the seams where we could inject fakes without changing production behavior.✓ コピーしました
    → Specific lines/functions to seam
  2. 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 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

コストと制限

運用コスト

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

トラブルシューティング

よくあるエラーと対処法

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 docsYou want canonical patterns not LLM-derivedNo codegen, slower

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る