Flutter test android visually
Skill lukas-hinterleitner/visual-app-skills/skills/flutter-test-android-visually
Agent skills for visually testing mobile apps on Android — run a Flutter, React Native, or native Android app on an emulator/device, capture real screenshots via adb, read logs, optionally diff against a Figma design, and verify the UI rendered correctly. Works with Claude Code and other coding agents.
npx -y skills add lukas-hinterleitner/visual-app-skills --skill flutter-test-android-visuallyAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Run a Flutter app on a connected Android device or emulator, capture real screenshots via adb, read the Dart + logcat logs, and verify the visible UI and runtime behavior match what a recent code change intended. Use whenever the user asks to "test the app", "run it on Android", "see the visual changes", "verify a UI fix", "check if my change works/renders", or otherwise wants empirical on-device confirmation that a Flutter change rendered correctly — even when they don't say "screenshot" or "logs". Handles launching with the right entry point and flags, waiting for the first real frame, navigating with adb input, capturing the screen, reading flutter + logcat output, and reporting a concrete verdict with evidence. Optionally diffs against a Figma reference when one is provided. Android only (iOS needs a Mac).
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.0 KB, 492 tokens by cl100k_base, as published. Nobody here has run it
Flutter Android visual test
Interactive, on-device verification of a Flutter Android app — the "did my last
change actually render correctly" check you'd otherwise do by squinting at an
emulator. Builds and runs the app on a device or emulator, captures real
screenshots via adb, reads the logs, and gives you enough evidence to answer
did the change render correctly.
Works for any Flutter app, including multi-entry apps where the default
entry point throws by design and a --target flag is mandatory. Android only —
iOS needs a Mac and xcrun simctl, which is out of scope here.
When to use
- "Test the app / run it on Android / see the visual changes."
- "Did my UI fix work? Does this screen render correctly now?"
- "Compare the capture screen to this Figma design." (optional Figma add-on)
- Any request for empirical, on-device confirmation of a visual or runtime change — even without the words "screenshot" or "logs".
How it works
- Follow
references/capture-loop.md— the universal procedure: preflight, launch in the background, wait for the first real frame, screenshot, capture logs, analyze the PNG against the change, report a verdict. - For the Flutter specifics — the exact
flutter runcommand and flags, the first-frame log signal, where Flutter logs, hot reload, and cold-build timing — readreferences/flutter.md. - To navigate the UI before screenshotting, see
references/driving-the-ui.md. - When something looks off, see
references/troubleshooting.md. - (Optional) compare to a Figma design →
references/figma-comparison.md(requires the Figma MCP server; skip entirely if you don't use Figma). - Reached here with a non-Flutter Android app? See
references/other-frameworks.mdor use the matching skill.
Bundled scripts
scripts/check-devices.sh, launch.sh, snap.sh, capture-logs.sh,
stop.sh wrap the common adb/run commands with device disambiguation.
capture-loop.md shows how they fit together.
What ships with it: 8 files
10.7 KB alongside SKILL.md
evals/
- evals.json2.3 KB
references/
- capture-loop.md42 B
- driving-the-ui.md44 B
- figma-comparison.md46 B
- flutter.md8.2 KB
- other-frameworks.md46 B
- troubleshooting.md45 B
- scripts20 B