メニュー
Base navigation patterns for Android device automation - gestures, waits, and UI interaction
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/rdmptv/AdbAutoPlayer --skill adb-navigation-baseコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| 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)