homekit skillB
homekit is agent-read markdown (skill) from omarshahine/homeclaw: Control HomeKit smart home accessories and view home events via homeclaw-cli. Use when the user asks to control lights, locks, thermostats, fans, blinds, scenes, check device/sensor status, or view recent home activity/events. Examples: "turn off the stairs lights", "lock the front door", "what's the temperature", "run the movie scene", "close the blinds", "is the garage door open", "what happened at home today", "when was the front door last unlocked".
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# HomeKit Control ## Golden Rule: Device Map First **Before your first HomeKit action in a session, read `memory/homekit-device-map.json`.** This compact device map has every device as a flat list with `display_name`, `id` (UUID), `room`, `type` (semantic category), `controls` (writable characteristics), and `state`. It's optimized for fast LLM scanning and disambiguation. **Refresh the cache** periodically or when devices may have changed: ```bash homeclaw-cli device-map --format agent -o memory/homekit-device-map.json ``` ## Resolving What the User Means 1. Match user's words against `display_name` and `room` from the cached map 2. **Use `type` to disambiguate** — `lighting` devices support brightness; `power` devices are on/off only. A "Closet Light" with `type: power` cannot dim. 3. If ambiguous, prefer the device in the most likely room (main living areas > bedrooms > outdoor) 4. If still ambiguous, ask 5. **Always use UUIDs for write operations** — many devices share names (9 "Overhead" lights, multiple "Blinds"). Use `display_name` for reading, `id` (UUID) for `set`, `import-scene`, and `automations create` commands …
Read the whole file at its exact version.
How to install
mdr add omarshahine/homeclaw/homekit@git:20260921.de0c7bbmdr add omarshahine/homeclaw/homekit@sha256:8b0c40aec083116ePin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_a3zltnktr4a473qc)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260921.de0c7bb latest | 2026-09-21 | de0c7bb | 25,437 B | B | view · diff |
| git:20260822.6f0a3ce | 2026-08-22 | 6f0a3ce | 25,012 B | B | view · diff |
| git:20260705.5387a15 | 2026-07-05 | 5387a15 | 22,161 B | B | view · diff |
| git:20260324.155a36b | 2026-03-24 | 155a36b | 21,850 B | B | view · diff |
| git:20260324.5b4cc64 | 2026-03-24 | 5b4cc64 | 21,786 B | B | view · diff |
| git:20260323.2543751 | 2026-03-23 | 2543751 | 21,188 B | B | view |
Audit of the latest version
- fail: No link to a raw IP address (matched: http://127.0.0.1:18789)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (25437 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No script tag
Source
omarshahine/homeclaw · 173 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_a3zltnktr4a473qc GET https://markdownregistry.com/api/v1/resolve?ref=omarshahine/homeclaw/homekit GET https://markdownregistry.com/api/v1/blob/8b0c40aec083116e4b65af986b2d86d29e5f8958298738b67c34dbfe6aaf743c
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from omarshahine/homeclaw
Every file in omarshahine/homeclaw