Aqara Smart Home AI Agent Skill

Basics

Aqara Open Host (default): agent.aqara.com (override via AQARA_OPEN_HOST)
Skill root: skills/aqara-agent/ (in-repo skill)
Python wrapper for the Aqara Open API: scripts/aqara_open_api.py — calls the API surface directly.

High-level order: deps → sign-in → pick home → intent → follow references/*.md and summarize.

Large models may hallucinate plausible homes, rooms, devices, states, or counts. For this skill, that is explicitly forbidden:

Sources of truth only: Homes, rooms, device names/IDs (for internal use), capabilities, live attributes (temperature, brightness, switch state, online/offline, etc.), lists, counts, logs, and control outcomes must come only from executed skill scripts and real Aqara API responses—or from user-supplied input the skill is designed to accept (e.g. pasted aqara_api_key). If the corresponding inquiry or control flow has not been run successfully, do not present any of that information as factual.
Never invent or “plausible-fill”: Example or demo-style device/home lists; guessed room layouts; assumed device counts; synthetic attribute values; fabricated success after errors, timeouts, skipped steps, or missing auth; JSON or prose that mimics API output without a real response.
When data is missing: State clearly that it could not be retrieved (and why, e.g. not signed in, API error), then follow auth/retry/references/—never substitute imagined content to make the answer feel complete.