# Android Device

> Android Device 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 device capabilities with device_status and device tools, including permissions, location, notifications, URL open, share, and settings recovery. Use for phone status, location, permissions, notifications, links, and Android system handoff tasks.

- Skill name: `android-device`
- 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-device/SKILL.md
- Repository: ModalityDance/PalmClaw (1,115 GitHub stars when collected)

## SKILL.md

# Android Device

Use `device_status` for state and permission checks.
Use `device` for system actions.

## Tool Map

- `device_status` with `action=info|permissions|location`
- `device` with `action=notify|open_url|share|open_app_settings`

## Default Automation Policy

- Set `request_if_missing=true` when permissions may be missing.
- Set `open_settings_if_failed=true` for automatic recovery.
- Set `wait_user_confirmation=true` only when the app cannot complete the system step itself.
- Avoid pre-confirmation for normal operations.

## Location Playbook

1. Call `device_status(action="location", provider="auto", prefer_fine=true)`.
2. If no fix, retry with `provider="network"`.
3. If location service is disabled, allow settings handoff and continue.
4. If still unavailable, return recoverable error with next step.

## Common Calls

- `device_status(action="permissions", permissions=[...], request_if_missing=true, open_settings_if_failed=true, wait_user_confirmation=true)`
- `device_status(action="location", provider="auto", prefer_fine=true, open_settings_if_failed=true, wait_user_confirmation=true)`
- `device(action="notify", title="...", text="...")`
- `device(action="open_url", url="https://...")`
- `device(action="share", text="...", subject="...")`

## Failure Recovery

- `permissions_missing` or `permissions_denied`: grant permissions and retry.
- `location_disabled`: enable location service in settings, then continue.
- `ui_unavailable`: foreground app and retry same call.

---

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