Skip to main content
skill CX Codex

reachy-mini — Claude Code skill for robot control

reachy-mini is a Claude Code skill for building Reachy Mini apps and controlling the robot. It activates for SDK tasks involving movement, camera or audio access, and LLM integration.

no license 1 installs updated 2025-12-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add gamepop/pg-skills --skill reachy-mini -a claude-code
Open on GitHub

What reachy-mini does

reachy-mini explains how to control a robot through the Python SDK: set head and antenna positions, point its gaze at a 3D location or image pixel, and run wake-up or sleep behaviors. goto_target() interpolates movement; set_target() applies a position immediately.

The skill covers camera and audio access, plus app creation by subclassing ReachyMiniApp. An LLM app can map tool calls to robot movement. The SDK works with physical hardware and MuJoCo simulation; simulation requires starting the daemon with --sim.

What it helps with

  • set Reachy Mini head and antenna positions
  • read camera frames and record audio
  • build an app with ReachyMiniApp
  • map LLM tool calls to robot movement

Example prompts for the agent

  • Write Python code that makes Reachy Mini look up and angle its antennas outward.
  • Create a ReachyMiniApp that reads frames from the camera.
  • Connect LLM tool calls to Reachy Mini head movement.

How to install reachy-mini

1Skills CLI (Vercel)

npx skills add gamepop/pg-skills --skill reachy-mini -a claude-code

2Manually: put the files in place

~/.claude/skills/reachy-mini/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reachy-mini/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about reachy-mini

How do I install reachy-mini in Claude Code?

Run npx skills add gamepop/pg-skills --skill reachy-mini -a claude-code. The skill file is at ~/.claude/skills/reachy-mini/SKILL.md.

What does reachy-mini do?

It helps write Python SDK code for Reachy Mini movement, camera and audio access. It also covers app development and connecting LLM tool calls to robot actions.

What is needed to run a Reachy Mini simulation?

Use the Python SDK and start the daemon with --sim. The SDK also supports physical Reachy Mini hardware.

Similar skills

SKILL.md skills catalog →

Project sponsors

Companies that keep this analytics open