Ble Hid
Apps & Automationble_hidBle Hid is an Agent Skill for apps & automation published in the espressif/esp-claw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Operate ESP-Claw BLE HID: start HID advertising and send media/keyboard/mouse actions.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/espressif/esp-claw/blob/HEAD/components/lua_modules/lua_module_ble_hid/skills/ble_hid/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ble-hid, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
BLE HID
Use this skill whenever the user asks to start BLE HID, make the device show up as a keyboard/mouse/media-control device, send media controls, type keys/text, or move/click/scroll the mouse.
Start BLE HID
{"path":"{CUR_SKILL_DIR}/scripts/start_ble_hid.lua","args":{"name":"esp-claw-hid"},"timeout_ms":10000}
BLE HID is a composite device. Media, keyboard, and mouse reports are all
available at the same time; the action type decides which report is sent.
Send One Action
Media:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"media","key":"play_pause"},"timeout_ms":5000}
Keyboard key:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_key","key":"SPACE"},"timeout_ms":5000}
Keyboard combo:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_combo","keys":["CTRL","C"]},"timeout_ms":5000}
Text:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_text","text":"hello"},"timeout_ms":5000}
Mouse:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"mouse_move","dx":30,"dy":0},"timeout_ms":5000}