adb-navigation-base

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

---

Quick Reference (30 seconds)

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:

• 👆 Smart Tap: Retry-enabled tapping with verification
• 👉 Swipe Gesture: Directional swiping for scrolling
• ⏱️ Wait For: Element/text waiting with polling

When to Use:

• Building reliable automation workflows
• Handling timing-sensitive UI transitions
• Creating reusable navigation patterns
• Combining with adb-screen-detection for full automation

---

Scripts

1. adb-tap.py

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:

• Automatic retry on failure (configurable attempts)
• Post-tap screen verification
• Timeout protection
• Detailed logging

---

2. adb-swipe.py

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