Roborock Vacuum Control

Control Roborock robot vacuums (status, clean, maps, consumables). Use when asked to vacuum, check vacuum status, control robot vacuum, or manage cleaning schedules. Triggers on vacuum, roborock, clean floor, hoover, robot cleaner keywords.

Security Scan

The skill is internally consistent: it documents using the 'roborock' CLI (python-roborock), asks for the expected interactive login and device ID, and does not request unrelated credentials or unusual installs.

Purpose & Capability

Name/description match the runtime instructions: all commands use the 'roborock' CLI and target device status, cleaning, maps, and consumables. The declared required binary ('roborock') is appropriate for the stated purpose.

Instruction Scope

SKILL.md instructs installing python-roborock and running 'roborock login' (interactive email/password) and device-specific commands — this is expected for controlling Roborock devices. There are no instructions to read unrelated files, export environment secrets, or send data to unexpected endpoints. Note: the skill requires you to enter your Xiaomi/Roborock account credentials into the third-party CLI.

Install Mechanism

The skill is instruction-only (no packaged install spec in the registry), but SKILL.md metadata and instructions recommend 'pipx install python-roborock' (a PyPI package). Installing from PyPI/pipx is common and reasonable here, but relies on trusting the python-roborock project and the package source (PyPI/GitHub).

Credentials

The skill requests no environment variables or other credentials. It does require user-provided account credentials interactively via the 'roborock login' CLI command, which is proportionate to the stated function.

Persistence & Privilege

always:false and no special system config changes are requested. The skill can be invoked autonomously (platform default), which is expected for a device-control skill; this means the agent could run vacuum commands without further prompts, but that capability matches the skill's purpose.

Assessment

This skill appears coherent, but take these precautions before installing: 1) Verify and review the upstream python-roborock project (GitHub/PyPI) so you trust the code that will run with your credentials. 2) Use pipx or a virtualenv as recommended to avoid contaminating system Python. 3) Be aware you'll enter your Xiaomi/Roborock account credentials into a third-party CLI — consider using a dedicated account if you want to limit exposure, and know how to revoke access from your account settings. 4) Understand that autonomous agent invocation can start/stop your vacuum; if that behavior would be disruptive, restrict when the skill is allowed to run. 5) Do not paste long-term secrets into other files unless you trust local storage; storing only the device ID (non-secret) in TOOLS.md is fine.

Control Roborock robot vacuums via the roborock CLI.

First-Time Setup

1. Install CLI

pipx install python-roborock

2. Login to Roborock Account

roborock login

Enter your Roborock/Xiaomi Home app email and password.

3. Find Your Device ID

roborock list-devices

Note your device ID (looks like AbCdEf123456789XyZ).

4. Store Device ID (Optional)

Add to your TOOLS.md for easy reference:

## Roborock Vacuum
- **Device ID:** your-device-id-here
- **Model:** Roborock S7 Max Ultra (or your model)

Quick Commands

All commands need --device_id "YOUR_DEVICE_ID" — replace with your actual device ID.

Check Status

roborock status --device_id "YOUR_DEVICE_ID"

Start Cleaning

roborock command --device_id "YOUR_DEVICE_ID" start

Stop/Pause

roborock command --device_id "YOUR_DEVICE_ID" stop
roborock command --device_id "YOUR_DEVICE_ID" pause

Return to Dock

roborock command --device_id "YOUR_DEVICE_ID" home

Clean Specific Room

First get room IDs:

roborock rooms --device_id "YOUR_DEVICE_ID"

Then clean specific rooms:

roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms 16,17

Maintenance Commands

Check Consumables

roborock consumables --device_id "YOUR_DEVICE_ID"

Shows filter, brush, sensor lifespans.

Reset Consumable

roborock reset-consumable filter --device_id "YOUR_DEVICE_ID"
roborock reset-consumable main_brush --device_id "YOUR_DEVICE_ID"
roborock reset-consumable side_brush --device_id "YOUR_DEVICE_ID"

Last Clean Record

roborock clean-record --device_id "YOUR_DEVICE_ID"

Clean Summary (All Time)

roborock clean-summary --device_id "YOUR_DEVICE_ID"

Maps & Rooms

Get Maps

roborock maps --device_id "YOUR_DEVICE_ID"

Cache Home Layout

roborock home

Save Map Image

roborock map-image --device_id "YOUR_DEVICE_ID" --output /tmp/vacuum-map.png

Room Features

roborock features --device_id "YOUR_DEVICE_ID"

Settings

Volume

roborock volume --device_id "YOUR_DEVICE_ID"
roborock set-volume 50 --device_id "YOUR_DEVICE_ID"

Do Not Disturb

roborock dnd --device_id "YOUR_DEVICE_ID"

LED Status

roborock led-status --device_id "YOUR_DEVICE_ID"

Child Lock

roborock child-lock --device_id "YOUR_DEVICE_ID"

Interactive Session

For multiple commands without repeating device ID:

roborock session --device_id "YOUR_DEVICE_ID"

Troubleshooting

Commands fail silently:

1. Check login: roborock login
2. Use debug mode: roborock -d status --device_id "YOUR_DEVICE_ID"
3. Ensure vacuum is online and connected to WiFi

"Device not found":

• Run roborock list-devices to verify device ID
• Make sure you're logged into the correct Roborock account

"Authentication failed":

• Re-run roborock login
• Check you're using the same account as your Xiaomi Home / Roborock app

Common Tasks

"Vacuum the house":

roborock command --device_id "YOUR_DEVICE_ID" start

"Vacuum the kitchen":

roborock rooms --device_id "YOUR_DEVICE_ID"  # find kitchen room ID
roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms <kitchen_id>

"Is the vacuum done?":

roborock status --device_id "YOUR_DEVICE_ID"

"Send vacuum home":

roborock command --device_id "YOUR_DEVICE_ID" home

"When did it last clean?":

roborock clean-record --device_id "YOUR_DEVICE_ID"

"Check brush/filter life":

roborock consumables --device_id "YOUR_DEVICE_ID"

Supported Models

Works with most Roborock vacuums including:

• Roborock S series (S4, S5, S6, S7, S8)
• Roborock Q series (Q5, Q7, Q8)
• Roborock E series
• Xiaomi Mi Robot Vacuum (Roborock-based)

Credits

Uses the python-roborock library.