Android UX Audit Skill

Reusable Codex skill for autonomous Android UX auditing via emulator.

This skill lets a Codex agent build a local Android app, run it on an emulator, navigate every screen and dialog, capture screenshots, analyze UX visually, inspect logs, and map findings back to source files.

What it does

• Builds and installs a debug APK.
• Starts or reuses an Android emulator.
• Navigates screens, dialogs, forms, menus, and states.
• Captures screenshots after key interactions.
• Analyzes screenshots visually for UX issues.
• Checks logcat for crashes and runtime errors.
• Maps findings to likely source files.
• Produces a detailed, prioritized Markdown report.

What it does not do

• Bypass authentication.
• Upload screenshots or logs.
• Include app-specific private data.
• Replace professional QA, design review, or accessibility testing.

Install

Copy the skill/android-ux-audit folder into your Codex skills directory:

Copy-Item -Recurse skill/android-ux-audit "$env:USERPROFILE\.codex\skills\android-ux-audit"

Usage

After installing the skill, prompt Codex with:

Use the android-ux-audit skill.

Open a visible Android emulator, build and install this app, let me log in manually if needed, then navigate every screen and dialog. Capture screenshots, analyze the UX visually, check logcat for crashes, map every issue back to source files, and create a detailed Markdown report named UX_CODEX_IMPROVEMENTS.md.

Requirements

• Android SDK installed with adb on PATH.
• Android Emulator with a configured AVD.
• Local Android project that builds a debug APK.
• Codex environment with shell access.

Privacy

Screenshots and logs may contain sensitive data. Redact personal information before sharing any report publicly. See SECURITY.md.

License

MIT.