flutter-screenshot

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

Jump to install

Repository: JustLookAtNow/pt_mate
Last source activity: June 10, 2026 at 09:40
Detected SKILL.md language: English
Stars: 491
Forks: 34

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/JustLookAtNow/pt_mate --skill flutter-screenshot

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

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

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.

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

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

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

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

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.

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.