flutter-screenshot

name	flutter-screenshot
description	Capture and show two Flutter UI screenshots for this project: one landscape/large-screen preview and one portrait/mobile preview, without using Flutter Web.

Flutter Screenshot Skill

Use this skill when the user asks to screenshot the Flutter app or a changed UI in this repository, especially when they want both desktop/large-screen and mobile/portrait previews. This project does not use Flutter Web for screenshots.

Workflow

1. Choose the entrypoint:

   • Use lib/main.dart unless a narrow preview is safer.
   • If a page-specific preview is needed, create a temporary entrypoint under /tmp and delete it after screenshots. Do not add preview entrypoints to the repo.

2. Run the bundled script from the repository root:

   python3 .agents/skills/flutter-screenshot/scripts/capture_flutter_screenshots.py \
     --target lib/main.dart \
     --output-dir /tmp/pt_mate_screenshots
   

3. The script starts flutter run -d linux, locates the app window, captures:

   • large.png at 1280x720
   • mobile.png at 393x852

4. Open both images with view_image before replying. Confirm they are not blank and show the expected screen.

5. Reply in Chinese with both Markdown image links:

   大屏预览：
   ![大屏预览](/tmp/pt_mate_screenshots/large.png)
   
   手机版预览：
   ![手机版预览](/tmp/pt_mate_screenshots/mobile.png)
   

Notes

• The script requires the Linux desktop Flutter target, X11, and ImageMagick import.
• In WSLg or remote desktop sessions, DISPLAY may be unset even when X11 is available. If xwininfo works with DISPLAY=:0, prefix the screenshot command with DISPLAY=:0.
• Use a longer --settle-seconds value when the first capture shows a loading screen; verify the captured images before copying or reporting them.
• Run the script with escalated permissions when the sandbox blocks GUI launch or X11 capture.
• Keep screenshots in /tmp long enough for the user to view them; clean up temporary preview Dart files when done.