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
npx skills add gamepop/pg-skills --skill reachy-mini -a claude-codeWhat 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
ReachyMiniAppthat 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-code2Manually: put the files in place
~/.claude/skills/reachy-mini/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reachy-mini/
1Skills CLI (Vercel)
npx skills add gamepop/pg-skills --skill reachy-mini -a codex2Manually: put the files in place
.agents/skills/reachy-mini/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gamepop/pg-skills --skill reachy-mini -a cursor2Manually: put the files in place
.cursor/skills/reachy-mini/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gamepop/pg-skills skills/reachy-mini2Manually: put the files in place
.github/skills/reachy-mini/SKILL.md1Skills CLI (Vercel)
npx skills add gamepop/pg-skills --skill reachy-mini -a gemini-cli2Platform CLI
gemini skills install https://github.com/gamepop/pg-skills --path skills/reachy-miniManually: put the files in place
.devin/skills/reachy-mini/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gamepop/pg-skills --skill reachy-mini -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.