fix-github-issue
Load agent-device skill. DO NOT SKIP
Fix a GitHub Issue
Constraints
These are hard rules. Violating any of them is a failure.
- NO mobile MCP — Never call any
mcp__mobile-mcp__*tool. No exceptions. - Device interaction =
agent-deviceonly — All simulator/emulator interaction (screenshots, taps, typing, scrolling, app launch/kill) MUST go throughagent-deviceCLI commands. Read the agent-device skill for allowed commands. Exception:adbis allowed for Android emulator setup (devices, install, reverse, shell getprop, screenrecord). - Reproduce first, code later — Always reproduce the issue on the simulator before exploring code. The bug might already be fixed. Do not explore the codebase until you have confirmed the bug exists. Exception: Feature requests and new example screens have nothing to reproduce — go straight to implementation.
- If you can't repro — When running interactively, stop and prompt the user with suggestions. When running on CI (no user), attempt to diagnose from code and issue description.
Steps
- Understand the issue and reproduce the problem using agent-device skill before exploring the code because the bug might not be there now. It will be good to initially add sample to the top of examples screen to avoid scrolling.
- Diagnose root cause
- Implement the fix
- Review your code for any obvious problems
More from shopify/flash-list
agent-device
Interact with iOS simulator or Android emulator/device using snapshot-based coordinates. Uses accessibility tree snapshots for precise element targeting, with screenshot verification as fallback. Use when navigating the app on a simulator/emulator.
11raise-pr
Create a GitHub PR for FlashList. Ensures no AI/Claude attribution in commits or PR body, follows repo conventions for title, description, and test plan.
7triage-issue
Triage a GitHub issue — classify priority (P0/P1/P2), search for duplicates, and apply labels.
7review-and-test
Review a FlashList PR or branch, run unit tests, test on iOS simulator, and verify RTL/LTR behavior. Shared context with fix-github-issue skill.
7analyze-feedback
Analyze agent feedback artifacts from GitHub Actions workflow runs, extract actionable learnings, and incorporate them into skill files and CLAUDE.md. Tracks scan progress to avoid re-processing.
7upgrade-react-native
Upgrade the React Native fixture app to a new version. Covers JS deps, Android (Gradle, Kotlin, SDK), iOS (Podfile, pbxproj), Metro config, and third-party libraries.
7