skills.rest
JuanCF
JuanCFCOMMUNITY
Explore all skills by this author →
GitHub

scrcpy-gotchas

Guide scrcpy-mcp users through Android device interaction pitfalls.

67|13|Updated Feb 20, 2026
Search Tags:#scrcpy#video streaming#file transfer#shell commands#UI interaction#Android device control
One-click install
npx skills add https://github.com/JuanCF/scrcpy-mcp --skill scrcpy-gotchas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scrcpy-gotchas
Source: https://github.com/JuanCF/scrcpy-mcp/tree/main/.opencode/skills/scrcpy-gotchas
Command: npx skills add https://github.com/JuanCF/scrcpy-mcp --skill scrcpy-gotchas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users of scrcpy-mcp navigate common pitfalls and optimize their experience with Android device control via scrcpy.

Core Features & Use Cases

  • Coordinate Systems: Clarifies the use of native coordinates for taps and swipes.
  • ui_find_element Matching: Details the behavior of matching rules for UI elements.
  • Non-ASCII Text Input: Provides workarounds for non-ASCII character input issues.
  • Scrolling: Offers guidelines for using scroll vs. swipe for scrolling content.
  • Key Events: Lists verified key events for device interaction.
  • Multi-app Switching: Explains app switching and recent app handling.
  • Screen Recording: Outlines screen recording options and limitations.
  • File Push/Pull: Covers file transfer operations between host and device.
  • Rotation: Describes rotation handling and coordinate space changes.
  • Shell Exec: Details executing shell commands for system info.
  • Video Streaming: Explains the video streaming feature and usage.
  • Launcher Home Screen: Describes navigating and interacting with the home screen.
  • Quick Settings: Guides users through the Quick Settings panel.
  • WhatsApp Specifics: Offers insights into WhatsApp usage with scrcpy-mcp.
  • Chrome/web Browsing: Covers web content accessibility and navigation.
  • Settings Deep Navigation: Explains navigating deep into settings.
  • System UI Elements: Details handling of system UI elements.

Quick Start

Use the scrcpy-gotchas skill to learn how to correctly tap and swipe on Android devices connected via scrcpy-mcp.

Frequently Asked Questions about scrcpy-gotchas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use native coordinates for taps and swipes when controlling an Android device?▼

Non-ASCII text input issues in scrcpy-mcp require specific workarounds to handle characters outside the standard ASCII range correctly. These solutions ensure accurate text transmission to the connected Android device.

What is the difference between scroll and swipe for scrolling content on an Android device?▼

The difference between scroll and swipe lies in their specific use cases for navigating content on an Android device. Following the established guidelines ensures correct vertical or horizontal movement behavior.

Does scrcpy-mcp require a separate installation on the host machine?▼

Yes, scrcpy-mcp requires installation on the host machine before you can interact with an Android device. This setup is necessary to enable video streaming, file transfer, and shell command execution.

Why does ui_find_element matching fail to locate UI elements during Android device control?▼

The ui_find_element matching fails when the matching rules are not fully understood or correctly applied during Android device control. Reviewing the detailed behavior of these rules ensures accurate UI element searching.

What are the limitations of screen recording when streaming video from an Android device?▼

Screen recording limitations when streaming video from an Android device include specific restrictions on options and duration. Understanding these constraints helps manage expectations for captured media output.

Related Skills

Explore More Software Engineering Skills→
asnar00asnar00
1

eos-screen-capture

Mirror Android device screens on macOS with scrcpy and optional live logs.

Community
Advanced
d-oitd-oit
13

shell-script-quality

Lint shell scripts with ShellCheck and run BATS test suites.

Community
Intermediate
clawperatorclawperator
2

utils.show-android-device

Launch scrcpy in read-only mode to observe Android device UI.

Official
Intermediate
pacphipacphi
6

mobile-testing

Automate mobile app QA across iOS and Android with Appium.

Community
Advanced