Menu
Base navigation patterns for Android device automation - gestures, waits, and UI interaction
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/rdmptv/AdbAutoPlayer --skill adb-navigation-baseThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | adb-navigation-base |
| description | Base navigation patterns for Android device automation - gestures, waits, and UI interaction |
| version | 1.0.0 |
| modularized | true |
| scripts_enabled | true |
| tier | 2 |
| category | adb-automation |
| last_updated | "2025-12-01T00:00:00.000Z" |
| compliance_score | 100 |
| dependencies | ["pytesseract>=0.3.10","pillow>=10.0.0","numpy>=1.24.0"] |
| auto_trigger_keywords | ["adb-navigation","gesture","swipe","wait-for","ui-interaction"] |
| scripts | [{"name":"adb-tap.py","purpose":"Smart tap with retry logic and verification","type":"python","command":"uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"},{"name":"adb-swipe.py","purpose":"Perform swipe gesture on device screen","type":"python","command":"uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"},{"name":"adb-wait-for.py","purpose":"Wait for element or text to appear with timeout","type":"python","command":"uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py","zero_context":true,"version":"1.0.0","last_updated":"2025-12-01T00:00:00.000Z"}] |
| color | cyan |
Base Navigation Patterns for Android Automation
What It Does: Provides fundamental gesture and wait-for patterns used in all UI automation. Smart retry logic, verification, and timeout handling.
Core Capabilities:
When to Use:
Smart tap action with automatic retry logic.
# Basic tap
uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py --x 100 --y 200
# Tap with retry (auto-retry on failure)
uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py --x 100 --y 200 --retry 3
# Tap with verification
uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py --x 100 --y 200 --verify-text "Next"
# Tap with both
uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py \
--x 100 --y 200 --retry 3 --verify-text "Loaded" --timeout 5
Features:
Perform directional swipe gesture.
# Swipe up (scroll down content)
uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py --direction up --distance 300
# Swipe left (next page)
uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py --direction left --distance 500
# Swipe with verification
uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py \
--direction down --distance 400 --verify-text "End of List"
# Custom start position
uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py \
--direction up --distance 300 --start-x 500 --start-y 1000
Directions: up, down, left, right Features:
Wait for UI element or text to appear.
# Wait for text (default 10s timeout)
uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py \
--method text --target "Loaded"
# Wait for element by text with timeout
uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py \
--method text --target "Login" --timeout 5
# Wait with polling interval
uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py \
--method text --target "Results" --interval 0.5
# JSON output for scripting
uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py \
--method text --target "Ready" --json
Detection Methods: text (OCR-based) Features:
# 1. Tap login button
adb-tap.py --x 100 --y 200
# 2. Wait for login form
adb-wait-for.py --method text --target "Username" --timeout 5
# 3. Swipe down to see password field
adb-swipe.py --direction down --distance 200
# 4. Tap password field
adb-tap.py --x 100 --y 300
# Tap with automatic retry (up to 3 times)
adb-tap.py --x 100 --y 200 --retry 3 --verify-text "Next Screen"
# 1. Start at top
# 2. Swipe up (scroll down) multiple times looking for element
for i in {1..5}; do
adb-swipe.py --direction up --distance 300
# Check if element appears
if adb-wait-for.py --method text --target "Find Me" --timeout 1; then
# Found! Tap it
adb-tap.py --x 150 --y 400
break
fi
done
Design Principles:
Dependency Relationship:
adb-screen-detection/ (provides capture, OCR, find-element)
↓
adb-navigation-base/ (uses for wait-for and verification)
↓
adb-workflow-orchestrator/ (coordinates these patterns)
Used By:
adb-workflow-orchestrator - Workflow step executionadb-magisk - Magisk Manager navigationadb-karrot - Karrot app automationDependency On:
adb-screen-detection - Screen capture and OCRadb command-line toolAttempt 1: Try action
├─ Success → Return
└─ Failure → Wait, Try again
Attempt 2: Try action
├─ Success → Return
└─ Failure → Wait, Try again
Attempt 3: Try action
├─ Success → Return
└─ Failure → Return error
This skill includes TOON-based workflow definitions for automation.
TOON (Task-Oriented Orchestration Notation) is a structured workflow definition language that pairs with Markdown documentation. Each workflow consists of:
This TOON+MD pairing approach is inspired by the BMAD METHOD pattern, adapted to use TOON instead of YAML for better orchestration support.
Workflow files are located in workflow/ directory:
Example Workflows (adb-navigation-base):
workflow/tap-and-wait.toon - Tap element and wait for resultworkflow/scroll-and-find.toon - Scroll to find elementworkflow/gesture-sequence.toon - Complex gesture combinationsExecute any workflow using the ADB workflow orchestrator:
uv run .claude/skills/adb-workflow-orchestrator/scripts/adb-run-workflow.py \
--workflow .claude/skills/adb-navigation-base/workflow/tap-and-wait.toon \
--param device="127.0.0.1:5555"
Each workflow includes comprehensive documentation in the corresponding .md file:
See the workflow/ directory for complete TOON file definitions and documentation.
To create custom workflows for this skill:
.toon file in the workflow/ directory.md file with comprehensive documentationFor more information, refer to the TOON specification and the workflow orchestrator documentation.
Version: 1.0.0 Status: ✅ Foundation Tier Scripts: 3 Last Updated: 2025-12-01 Tier: 2 (Foundation)