# Android Bluetooth

> Android 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.

- Skill name: `android-bluetooth`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/ModalityDance/PalmClaw/blob/HEAD/app/src/main/assets/skills/android-bluetooth/SKILL.md
- Repository: ModalityDance/PalmClaw (1,115 GitHub stars when collected)

## SKILL.md

# Android Bluetooth

Use `bluetooth` for all Bluetooth and BLE actions.

## Tool Map

- `action=status`
- `action=set_power`
- `action=open_settings`
- `action=paired_list`
- `action=ble_scan`
- `action=ble_connect`
- `action=ble_disconnect`

## Default Automation Policy

- Auto-attempt permission request first.
- Keep `open_settings_if_failed=true` for permission fallback.
- Keep `wait_user_confirmation=true` only for manual system steps.
- Use `allow_manual_success=true` only when manual setup is acceptable for upstream task flow.

## Connect Playbook

1. `bluetooth(action="status")`.
2. If needed: `bluetooth(action="set_power", enabled=true)`.
3. Discover: `bluetooth(action="ble_scan", seconds=5, max_results=20)`.
4. 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.

---

Source: https://www.openparable.com/skill/apps-automation/android-bluetooth (OpenParable). Cite the canonical URL above.
