pratos/adb-ui-tree
skills/adb-ui-tree/SKILL.md
Automates Android UI-tree debugging via ADB. Use when an app blocks UI inspection or accessibility nodes are missing; collects uiautomator dumps, focused window info, and logcat hierarchy dumps for analysis.
$ install --global
skillsauthnpx skillsauth add pratos/clanker-setup adb-ui-treeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 8:21 AM40.0s1 file scanned
SKILL.md
- name:
- adb-ui-tree
- description:
- Automates Android UI-tree debugging via ADB. Use when an app blocks UI inspection or accessibility nodes are missing; collects uiautomator dumps, focused window info, and logcat hierarchy dumps for analysis.
ADB UI Tree Debugging Skill
Activation
When this skill is triggered, ALWAYS display this banner first:
╭─────────────────────────────────────────────────────────────╮
│ 📱 SKILL ACTIVATED: adb-ui-tree │
├─────────────────────────────────────────────────────────────┤
│ Target: [app/screen being inspected] │
│ Action: Collecting UI hierarchy via ADB... │
│ Output: ui.xml, screen.png, accessibility logs │
╰─────────────────────────────────────────────────────────────╯
Use this skill when you need to inspect Android UI trees, especially when an app blocks normal debugging/inspection. It provides a repeatable, automatic flow to collect UI hierarchy data, focused window info, and accessibility logs.
Preconditions
- ADB is installed and available.
- A device is connected and authorized (
adb devices). - The target app is open on screen.
Steps
- Verify device connectivity
adb devices
If multiple devices are attached, use -s <serial> for all commands.
- Confirm focused window
adb shell dumpsys window windows | grep -E "mCurrentFocus|mFocusedApp"
Ensure the focused app is the target (e.g., iSmart).
- Try UIAutomator dump (may be blocked)
adb shell uiautomator dump /sdcard/ui.xml
adb pull /sdcard/ui.xml .
If the app blocks the dump, note the error and continue to step 4.
- Collect accessibility hierarchy logs If the project includes a custom AccessibilityService that logs a hierarchy dump, trigger the automation and capture logcat:
adb logcat -s BatteryTrackerA11y
Save the output for analysis.
- Capture a screenshot for manual inspection
adb exec-out screencap -p > screen.png
Use the screenshot to verify UI state and map coordinates if needed.
Notes / Fallbacks
- If the app exposes no accessibility nodes, consider coordinate-based taps as a fallback.
- If
uiautomator dumpis prohibited by the app, rely on AccessibilityService logs and screenshots.
Output to share
ui.xml(if available)adb logcat -s BatteryTrackerA11youtputscreen.png
Related Skills
pratos/web-search-researcher
development
VerifiedTrustedCommunity
Conducts comprehensive web research to find accurate, relevant information. Use when you need modern information only discoverable on the web, documentation, best practices, or technical solutions. Uses curl+markdown.new, Exa/Parallel APIs, and camoufox browser — no surf/WebFetch/WebSearch.
11SKILL.mdUpdated May 20, 2026
pratos/uv-python-execution
development
VerifiedTrustedCommunity
Enforces using uv to run all Python scripts and ty for type checking. Includes inline script metadata (PEP 723) for one-time scripts with dependencies.
11SKILL.mdUpdated May 20, 2026
pratos/ts-dotenv-override
development
VerifiedTrustedCommunity
Ensures .env files in TypeScript projects override sops-nix shell secrets. Use when setting up env loading, debugging missing/wrong API keys, or configuring dotenv in TS projects.
11SKILL.mdUpdated May 20, 2026
pratos/traces
tools
VerifiedTrustedCommunity
Share agent session traces via the traces CLI. Use when the user asks to share/publish/upload a trace. Always use private visibility.
11SKILL.mdUpdated May 20, 2026