desage56/ayn-thor-claude-skill

This repository is a skill for Claude Code, the AI coding assistant, that teaches it how to operate a specific piece of hardware: the AYN Thor, a handheld Android gaming device. It lets Claude connect to the device from a PC using ADB, a standard Android debugging tool, and then install and update emulators, configure the device's Cocoon launcher, transfer game files, and troubleshoot common problems like a game not showing up in the library. The author built this after going through a long real setup and troubleshooting session with their own device, so the skill is full of specific, hard won details, such as which button presses the Cocoon interface actually responds to, common mistakes that accidentally delete a platform entry, quirks in how Android's file picker grants folder access, and path handling issues on Windows. The skill is organized into a main file with device facts and core rules, plus separate reference files covering UI navigation, the recommended emulator setup, and library maintenance tasks like backups and organizing multi disc games. Since Claude is controlling a real device remotely without seeing the screen directly, the skill relies on a screenshot, then verify, then act pattern to avoid mistaken taps. Installing it means copying a folder into your personal Claude Code skills directory. It requires ADB installed on your PC and USB debugging turned on on the device. The README is explicit that it does not include or download any ROMs, BIOS files, or firmware, and instructs Claude to only install emulators from official sources. This is aimed at AYN Thor owners who already use Claude Code and want help managing their handheld's software, rather than at general developers. It is released under the MIT license.