verify-notes

Drive an Android app on an emulator via Gradle assemble and the android CLI for visual verification.

1|Updated Aug 26, 2026
One-click install
npx skills add https://github.com/edivad1999/stuc-stack --skill verify-notes-edivad1999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify-notes
Source: https://github.com/edivad1999/stuc-stack/tree/main/skills/create-verification-skill/references/verify-notes-example
Command: npx skills add https://github.com/edivad1999/stuc-stack --skill verify-notes-edivad1999

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Verifying Android UI changes often stops at green unit tests, which prove nothing about what a user actually sees on a device. This Skill defines a repeatable loop that builds a debug APK with Gradle, deploys it to an emulator with the android CLI, and captures layout JSON and screen PNGs as real visual evidence. ## Core Features & Use Cases - Device-driven verification: Launch an emulator this run owns, deploy the APK via android run, and drive screens with layout inspection, screen capture, and input commands. - Feature-map coverage: A features/ directory maps each user-facing area (save note, search, empty/error states, multi-surface journeys) with entry points, success/cancel/error/empty/persistence paths, and proof requirements. - Fail-closed doctor checks: Verify the android CLI, adb serial, and assemble receipts before driving, and stop instead of faking device proof when the environment is broken. - Use Case: After changing the note editor, run the save-note feature flow on an emulator, capture layout JSON and a PNG showing the saved row, and report exactly which commands ran and which checks were skipped. ## Quick Start Ask the agent to verify the Notes app save and search flows on an emulator using the android CLI and produce layout JSON and screenshot evidence.

Frequently Asked Questions about verify-notes

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

FAQPage Schema
How do I verify Android UI changes on an emulator with the android CLI?▼

Assemble the debug APK with Gradle, start an emulator the run owns, deploy with android run using APK paths from android describe, then drive screens with android layout, screen capture, and adb input. Capture layout JSON and PNGs as evidence.

What is the difference between unit tests and device verification on Android?▼

Host unit tests like testDebugUnitTest run on the JVM and never render the UI, so a green test is not visual coverage. Device verification drives the actual APK on an emulator and captures layout JSON or screenshots of real rendered screens.

Can I run this verification on my physical Android phone?▼

No. The Skill requires one emulator serial that the current run started and explicitly refuses to drive the user's physical device or a shared emulator. Teardown stops only emulators this run started.

Why does the verification fail closed when the android CLI is missing?▼

If the android binary is not on PATH or the official android-cli skill does not resolve, the Skill stops and prints the download and setup instructions instead of proceeding. This prevents agents from faking device proof without a real driver.

What evidence counts as done for an Android UI verification?▼

Done requires the named assemble task to have run, android run to have used APKs from describe, and at least one layout JSON, screen PNG, preview PNG, or journey JSON on disk. The reply must list commands actually executed and name any checks not run.