Agent skill

Ecovacs

by Anil-matcha in Anil-matcha/awesome-muse-connectors

Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return.

MITAuto-check passedDatabases

Install Ecovacs

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/ecovacs .claude/skills/ecovacs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .claude/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .agents/skills && cp -r skills-src/connectors/ecovacs .agents/skills/ecovacs && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .agents/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/connectors/ecovacs .cursor/skills/ecovacs && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .cursor/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Anil-matcha/awesome-muse-connectors.git --path connectors/ecovacs

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/connectors/ecovacs .gemini/skills/ecovacs && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .gemini/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .github/skills && cp -r skills-src/connectors/ecovacs .github/skills/ecovacs && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .github/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Anil-matcha/awesome-muse-connectors ecovacs --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/connectors/ecovacs .opencode/skills/ecovacs && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "ecovacs" agent skill from https://github.com/Anil-matcha/awesome-muse-connectors/tree/main/connectors/ecovacs into .opencode/skills/ecovacs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ecovacs", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: ecovacs
GitHub stars: 1.3k
Token cost: ~1.3k tokens
SKILL.md length: 548 words
Files: 2
Skills in repo: 153
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return.

Works in 6 steps: clean (start cleaning) is a MEDIUM… → Pause, resume, stop, dock return, and… → Discovery and control use the documented… → …
Phrases: ecovacs
SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
Runs Python scripts from its folder

What it does

Ecovacs is an agent skill from Anil-matcha/awesome-muse-connectors. Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return. Trigger phrases: ecovacs, deebot, robot vacuum, start cleaning, dock vacuum.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/ecovacs.py`).

It sits in Databases, covering Database administration. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

Phrases: ecovacs
Tasks that involve Database administration

Example prompts

“/ecovacs”

Requirements

Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

clean (start cleaning) is a MEDIUM actuation: the robot drives itself around the home. It needs --confirm "start cleaning on " naming the…
Pause, resume, stop, dock return, and work-mode changes are LOW: they are trivially reversible and need no confirmation, but the assistant…
Discovery and control use the documented gateway paths only (/robot/skill/deviceList, /robot/skill/ctl with CloudCtl commands Clean…
What actually works depends on model, firmware and whether the robot is online. A ret=fail with errno=5009 means the command or casing is…
Pricing and quotas were unpublished at build time; check the Open Platform console for current terms.
Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the AK value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ecovacs loads about 1.3k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 548 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~57
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 548 words, ~1,334 tokens.

Download SKILL.mdSave it as .claude/skills/ecovacs/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: ecovacs
description: Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return. Trigger phrases: ecovacs, deebot, robot vacuum, start cleaning, dock vacuum.
metadata.includeInPrompt: true
tagline: Control Ecovacs DEEBOT robot vacuums through the official Ecovacs Open Platform: list bound robots, read robot state and battery, start/pause/resume/stop…
catalog_auth: Access Key via the secure credential flow
catalog_hosts: open.ecovacs.com, open.ecovacs.cn

Ecovacs

Purpose

Control Ecovacs DEEBOT robot vacuums through the official Ecovacs Open Platform: list bound robots, read robot state and battery, start/pause/resume/stop cleaning, send the robot back to its dock, and set the sweep/mop work mode. Use when the user mentions their DEEBOT or robot vacuum.

Tooling

All commands go through bin/ecovacs.py. --region selects the Open Platform region (global for open.ecovacs.com, cn for open.ecovacs.cn; default global) and must match the region of the user's Ecovacs account and robots. --robot is the robot's nickname (a fragment of the name shown in the app is enough for the gateway to match it).

bash

bin/ecovacs.py auth --region global                 # verify the Access Key
bin/ecovacs.py devices                              # list bound robots
bin/ecovacs.py status --robot Blue                  # cleaning/paused/docked state
bin/ecovacs.py battery --robot Blue                 # battery percent
bin/ecovacs.py stats --robot Blue                   # area cleaned, duration

# MEDIUM: cleaning start needs --confirm "<exact effect>" on first use per robot
bin/ecovacs.py clean --robot Blue --confirm "start cleaning on Blue"

# LOW: no confirmation
bin/ecovacs.py pause --robot Blue
bin/ecovacs.py resume --robot Blue
bin/ecovacs.py stop --robot Blue
bin/ecovacs.py dock --robot Blue
bin/ecovacs.py undock --robot Blue
bin/ecovacs.py set-work-mode --robot Blue --mode 0  # 0=sweep+mop, 1=sweep only, 2=mop only, 3=sweep then mop

The clean command starts a whole-home clean. Zone/room cleaning needs area IDs from the map and is not shipped; use the app for targeted cleans.

Auth

Provider id: ecovacs (credential is collected as custom.ecovacs)
Collection: self-serve Access Key (AK) created or viewed in the Ecovacs Open Platform console under Service overview, stored via the secure credential flow (credentials.request_api_access) with query-param placement on ak. The AK is passed as ?ak= on the request URL, per Ecovacs' vendor-published Deebot skill reference; it never appears on the command line, in the environment, or in a file.
Allowed hosts: open.ecovacs.com, open.ecovacs.cn (selected with --region)
Status check: bin/ecovacs.py auth (must return "ok": true)
Region matters: use the same regional portal for the AK, the account, and the robots, or calls fail with AK/permission errors. This is the most common setup mistake.

Operating Rules

clean (start cleaning) is a MEDIUM actuation: the robot drives itself around the home. It needs --confirm "start cleaning on <robot>" naming the exact robot on first use per robot; the CLI records it locally (~/.cache/muse-connectors/ecovacs/confirmed.json) and later runs proceed without asking.
Pause, resume, stop, dock return, and work-mode changes are LOW: they are trivially reversible and need no confirmation, but the assistant should still say what it is about to do in chat for dock/undock.
Discovery and control use the documented gateway paths only (/robot/skill/deviceList, /robot/skill/ctl with CloudCtl commands Clean, Charge, GetWorkState, GetBatteryInfo, GetStats, SetWorkMode). Control requests carry the AK as ?ak= on the request URL; the vendor reference also documents it in the JSON body, so if the gateway rejects the query placement, confirm the placement against the Open Platform docs rather than changing the code.
What actually works depends on model, firmware and whether the robot is online. A ret=fail with errno=5009 means the command or casing is not supported on that model; 10000 means low battery; 10004 means offline.
Pricing and quotas were unpublished at build time; check the Open Platform console for current terms.
Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the AK value.

Show full SKILL.md (96 more words)Show less

Files

SKILL.md
bin/ecovacs.py

Maturity

🧪 Draft: written from Ecovacs' Open Platform materials and the vendor-published Deebot skill reference; not yet live-tested end-to-end.

Honesty flags: the gateway paths and the CloudCtl command/data shapes (Clean with act s/p/r/h, Charge with act go/stopGo, GetWorkState, GetBatteryInfo, GetStats, SetWorkMode) are pinned in the vendor-published skill reference (2026-09-16), but no live call has been made from this CLI. The AK-as-query-param placement on POST /robot/skill/ctl follows the documented GET semantics; if the gateway requires the AK in the JSON body for control calls, adjust the credential placement at setup instead of changing the code.

Files

SKILL.md and 1 other file in connectors/ecovacs of Anil-matcha/awesome-muse-connectors.

SKILL.md
bin/ecovacs.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Ecovacs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ecovacs compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Ecovacs this skillAnil-matcha/awesome-muse-connectors	1.3k	—	~1.3k	Automated safety check: Pass	MIT	5 days ago
Hybrid Cloud Outboxesgetsentry/sentry	46k	—	~4.8k	Automated safety check: Pass	Custom licence	today
Replicate Video AdJingyi-Wu-Richael/replicate-video-ad	108	1 repos	~1.6k	Automated safety check: Pass	None	1 mo ago
Sea Orm 2FlyinPancake/yoink	112	—	~2.9k	Automated safety check: Pass	Apache-2.0	5 days ago
Pixel Perfect ReplicationYu-369/VibeCurb	979	—	~8.7k	Automated safety check: Pass	MIT	2 mo ago
Horse Database PoolingHashLoad/horse	1.4k	—	~1.4k	Automated safety check: Pass	MIT	3 days ago

Similar skills

Hybrid Cloud Outboxes
getsentry/sentry
Official
Guide for creating and maintaining outbox-based eventually consistent operations in Sentry.
46k GitHub stars~4.8k tokensUpdated today
DatabasesAuto-check passed
Replicate Video Ad
Jingyi-Wu-Richael/replicate-video-ad
Analyze a reference video frame by frame and turn its visual grammar, story beats, dialogue, product reveal, proof sequence, and conversion structure into a production-ready ecommerce story-ad…
108 GitHub starsUsed in 1 repo~1.6k tokens
DatabasesAuto-check passed
Sea Orm 2
FlyinPancake/yoink
Expert guidance for SeaORM 2.0, Rust's async ORM with strongly-typed columns, nested ActiveModels, Entity Loader API, and entity-first workflow.
112 GitHub stars~2.9k tokensUpdated 5 days ago
DatabasesAuto-check passed
Pixel Perfect Replication
Yu-369/VibeCurb
Image-to-code replication pipeline. An agent skill from Yu-369/VibeCurb.
979 GitHub stars~8.7k tokensUpdated 2 mo ago
DatabasesAuto-check passed
Horse Database Pooling
HashLoad/horse
Guide for setting up thread-safe database connection pooling (FireDAC / UniDAC) in multithreaded Horse applications.
1.4k GitHub stars~1.4k tokensUpdated 3 days ago
DatabasesAuto-check passed
Redis Clustering
redis/agent-skills
Official
Redis Cluster and replication guidance covering hash tags for multi-key operations, avoiding CROSSSLOT errors, and reading from replicas to scale read-heavy workloads.
166 GitHub starsUsed in 1 repo~1k tokens
DatabasesAuto-check passed

Questions about Ecovacs

What does Ecovacs do?

Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return. Ecovacs is an agent skill from Anil-matcha/awesome-muse-connectors. Control Ecovacs DEEBOT robot vacuums through the Ecovacs Open Platform: device list, status, battery, cleaning start/pause/stop, dock return.

When should I use Ecovacs?

Ecovacs fits situations like: phrases: ecovacs; tasks that involve Database administration.

How do I install Ecovacs in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a claude-code`. Or copy the skill folder (connectors/ecovacs in Anil-matcha/awesome-muse-connectors) into .claude/skills/ecovacs in your project. Claude Code loads it when a task matches its description.

How do I install Ecovacs in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a codex`. Or copy the skill folder (connectors/ecovacs in Anil-matcha/awesome-muse-connectors) into .agents/skills/ecovacs in your project. Codex loads it when a task matches its description.

Can I use Ecovacs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Anil-matcha/awesome-muse-connectors --skill ecovacs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ecovacs, .gemini/skills/ecovacs, .github/skills/ecovacs and .opencode/skills/ecovacs in your project.

What does Ecovacs need to run?

Going by SKILL.md and its folder, Ecovacs needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Ecovacs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ecovacs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ecovacs use?

Ecovacs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ecovacs use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ecovacs?

Skills that share tags, products or a category with Ecovacs: Hybrid Cloud Outboxes (getsentry/sentry, 46k stars), Replicate Video Ad (Jingyi-Wu-Richael/replicate-video-ad, 108 stars), Sea Orm 2 (FlyinPancake/yoink, 112 stars) and Pixel Perfect Replication (Yu-369/VibeCurb, 979 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ecovacs?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Ecovacs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Ecovacs

Purpose

Tooling

Auth

Operating Rules

Files

Maturity

Files

Compare with similar skills

Similar skills

More from Anil-matcha/awesome-muse-connectors

Related

Questions about Ecovacs