Claude Code plugin

Your AI agent, robotics-ready.

robium equips Claude Code with battle-tested robotics engineering skills — stack selection, simulation, navigation, learned manipulation — so your agent builds robot applications that pass their smoke tests, not just compile.

claude — manip-trial
 > start manip-trial ⏺ robium:architect — manipulation golden path
  stack: LeRobot 0.6.0 · gym-pusht · uv (Python 3.12) · MPS
  brief written → docs/architecture-brief.md
$ make smoke
tests/test_smoke.py::test_train_completes PASSED
tests/test_smoke.py::test_eval_produces_metrics PASSED 2 passed in 39.51s
How it works

From idea to a smoke-tested robot app.

01

Describe the robot app

"Autonomous navigation in sim" or "train a manipulation policy" — plain language, in your Claude Code session.

> build a mobile robot that
  navigates a warehouse
02

Skills route the stack

The architect skill turns requirements into a verified stack decision and writes an architecture brief your whole build follows.

middleware  ROS 2 Jazzy
nav         Nav2
sim         Gazebo Harmonic
viz         Foxglove
03

Build and see it run

Reproducible envs (uv or Docker), headless simulation, browser visualization — local and remote runs behave identically.

gz sim -s --headless-rendering
foxglove ws://localhost:8765
RTF ≈ 0.99
04

Smoke test gates done

An app is not done until one command proves it: robot reaches its goals, policy trains and evals with metrics. Exit code 0 or it is not shipped.

$ make smoke
PASS: all goals reached
exit 0
Skill catalog

21 skills. One coherent robotics brain.

Generated from the repo at build time — versioned, battle-tested on real builds, and hardened by a continuous learning loop.

architect v1.2.0

Entry-point skill for designing robotics applications with AI agents. Turns requirements (robot type, task, hardware, sim-vs-real, GPU/budget) into a full stack decision — middleware, simulation, data, visualization, training frameworks — plus a scaffold plan and a written architecture brief.

data v1.0.0

Data sourcing strategy for robotics and physical-AI: choose between offline datasets (HuggingFace hub, Open X-Embodiment and similar), simulation-generated data, and teleop/real-robot collection; plan storage formats, episode structure, and dataset versioning.

environments v1.1.1

Virtual-environment-first setup for robotics projects: decide uv/venv vs Docker, make local and remote-server runs reproduce identically, handle GPU passthrough and headless/display forwarding.

foxglove v1.1.2

Foxglove for robotics visualization: foxglove_bridge setup for live ROS 2 robots, layouts, MCAP recording and playback, and remote/web visualization of robots running on servers.

gazebo v1.1.1

Modern Gazebo (gz — Harmonic/Ionic line) simulation: SDF worlds and models, sensors (lidar, camera, IMU, contact), the ros_gz bridge, spawning robots, and headless/server operation.

huggingface v1.0.1

HuggingFace ecosystem for robotics projects: hub datasets and models for robot learning, and demo Spaces. DELEGATES: for hub mechanics (download/upload/auth/jobs), install HuggingFace's own skills — /plugin marketplace add huggingface/skills, then /plugin install hf-cli@huggingface-skills — and defer to them; this skill adds only the robotics-specific layer (which datasets and models matter for manipulation and navigation, robotics dataset conventions on the hub).

integration v1.1.0

Glue robotics modules into one running system: choose module boundaries, pick inter-module communication (ROS 2 topics/services/actions, zenoh, gRPC, REST, shared memory), and write solid Dockerfiles and docker-compose for robotics workloads.

isaac-lab v1.0.1

NVIDIA Isaac Lab: reinforcement-learning and imitation-learning workflows on top of Isaac Sim — prebuilt environments and tasks, training runs, and exporting policies.

isaac-sim v1.0.1

NVIDIA Isaac Sim: installation and container setup, GPU/driver requirements, USD scenes, robots and sensors, the ROS 2 bridge, and headless/livestream operation for remote servers.

lerobot v1.1.1

HuggingFace LeRobot for physical-AI manipulation: the LeRobotDataset format, loading and recording episodes, training policies (ACT, diffusion, pi0), evaluating in simulation, and teleoperation.

live-demo v1.0.0

Turn a working robium app into a public, interactive web demo: a mission-control demo page (start/stop instance buttons, live boot terminal, fleet budget), per-visitor simulator instances on Cloud Run (scale-to-zero), and a visualizer handoff (Foxglove deep link or self-hosted viewer).

nav2 v1.1.1

Nav2 mobile-robot navigation for ROS 2: bringup, behavior trees, costmaps, planner/controller servers, localization (AMCL, slam_toolbox), waypoint following, and tuning.

rerun v1.0.1

Rerun for data-centric robotics and ML visualization: logging APIs (Python), timelines, entity paths, and viewing policy rollouts, episode data, and sensor streams.

ros2 v1.0.1

Core ROS 2 usage: workspaces, colcon builds, packages (ament_python/ament_cmake), nodes, topics/services/actions, QoS, launch files, parameters, TF2, rosdep, and gluing third-party packages together.

rviz2 v1.0.1

RViz2 visualization for ROS 2: displays, TF frame debugging, markers, saved config files, and the common 'nothing shows up' fixes (fixed frame, QoS, sim time).

simulation v1.0.0

Choose and set up robotics simulators, and simulate sensors correctly: Gazebo vs Isaac Sim selection, sensor fidelity (rates, noise models, frames matching the real robot), determinism, and sim-to-real considerations.

skill-author v1.1.0

Author and improve robium skills. Three modes: fresh authoring from skills/_TEMPLATE, mining skills out of existing repos and apps, and hardening skills from learnings/ notes after trial runs. Enforces the robium quality bar (template compliance, trigger-surface descriptions, <500-line bodies, stated delegation posture, upstream links, no invented syntax) and runs scripts/validate_skills.py.

skill-refiner v1.0.1

Curation pass over the robium skill catalog: measure bloat against token budgets, find cross-skill duplication and overlap worth merging, sweep dated version/status facts for staleness, and review which skills never fire so their trigger surface or existence gets questioned.

skill-updater v1.1.1

Fold the current session's learnings back into the robium skills, on demand. Harvests gotchas from the conversation and any unabsorbed learnings/ files, confirms the list, then edits the robium source checkout: fixes wrong/stale guidance, widens missed trigger surfaces, adds figured-out-from-scratch knowledge, prunes noise, and promotes ✓-verified examples.

testing v1.1.0

Test-driven robotics development: smoke tests for launch files, sim-based regression tests, node-level unit tests, policy eval as a test, and CI patterns for robotics repos.

visualization v1.0.1

Choose and apply robotics visualization: selection guidance for rviz2 vs Foxglove vs Rerun, plus best practices — what to visualize at each dev stage, live vs recorded, local vs remote.

Proof, not promises

Built by the plugin. Gated by smoke tests.

Every reference app in robium-applications is built with the skills and stays green — the apps are the regression suite, and the registry tells the next build what to bootstrap from.

nav-trial

ROS 2 Jazzy · Nav2 · slam_toolbox · Gazebo Harmonic · Docker (arm64) · Foxglove

TurtleBot 3 maps its world with SLAM, then navigates goals on the saved map — fully headless on a MacBook, visualized in the browser.

make smoke — nav-trial
9/9 waypoints SUCCEEDED — map saved 111×103
AMCL localized, 2 map-frame goals SUCCEEDED PASS: all goals reached · exit 0 · 94 s wall
Try the live demo →

manip-trial

LeRobot 0.6.0 · ACT policy · gym-pusht · uv · Apple-silicon MPS

An imitation-learning policy trains on the PushT dataset and evaluates in sim with metrics — on a GPU-less laptop. Below: a real evaluation rollout.

Works with the stack you already trust
ROS 2 Nav2 Gazebo LeRobot Hugging Face Isaac Sim Foxglove Rerun RViz2 Docker uv ROS 2 Nav2 Gazebo LeRobot Hugging Face Isaac Sim Foxglove Rerun RViz2 Docker uv
Get started

Two commands in Claude Code.

claude
 /plugin marketplace add mdemirst/robium /plugin install robium@robium  20 robotics skills loaded — start with:
> build a mobile robot that navigates in sim 

Then just describe your robot application. Full docs in the README.