Android Bluetooth
Apps & Automationandroid-bluetoothAndroid Bluetooth is an Agent Skill for apps & automation published in the ModalityDance/PalmClaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Operate Android Bluetooth workflows with the bluetooth tool, including power, pairing handoff, BLE scan/connect/disconnect, and permission/settings recovery. Use for Bluetooth and BLE device tasks.
QUICK START
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.
Prompt to paste
Inspect the Agent Skill at https://github.com/ModalityDance/PalmClaw/blob/HEAD/app/src/main/assets/skills/android-bluetooth/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/android-bluetooth, 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.
Android Bluetooth
Use bluetooth for all Bluetooth and BLE actions.
Tool Map
action=statusaction=set_poweraction=open_settingsaction=paired_listaction=ble_scanaction=ble_connectaction=ble_disconnect
Default Automation Policy
- Auto-attempt permission request first.
- Keep
open_settings_if_failed=truefor permission fallback. - Keep
wait_user_confirmation=trueonly for manual system steps. - Use
allow_manual_success=trueonly when manual setup is acceptable for upstream task flow.
Connect Playbook
bluetooth(action="status").- If needed:
bluetooth(action="set_power", enabled=true). - Discover:
bluetooth(action="ble_scan", seconds=5, max_results=20). - Connect:
bluetooth(action="ble_connect", address="...", timeout_sec=20, discover_services=true, open_settings_if_failed=true, wait_user_confirmation=true).
Disconnect Playbook
- Single:
bluetooth(action="ble_disconnect", address="...") - All:
bluetooth(action="ble_disconnect", all=true)
Failure Recovery
- Permission failures: grant in settings and continue same run.
- Power-off failure: hand off to system Bluetooth settings, then continue.
- Connect timeout: retry once, then return recoverable error with next step.