use-workflow-pageshot

use-workflow-pageshot - PR Screenshot/Video Helper

Internal helper invoked by /pr when UI changes are detected. Not for direct user invocation.

Input

Field	Source
Preview URL	The leading Preview URL: <URL> line in the PR body
Steps	Numbered list under the ## How to Test section in PR body

PR body is passed as a string from /pr. If Preview URL or How to Test is missing, return mode: failed with the missing field name and let /pr decide.

Mode Selection

Steps count	Mode	Artifact
1	screenshot	step-01.png
2+	video	capture.mp4

Execution

Step	Action
1	Create output directory: ${CLAUDE_SKILL_DIR}/../../workspace/pageshot/$(date +%Y%m%d-%H%M%S)/
2	agent-browser open {Preview URL}
3	Run Screenshot Flow or Video Flow based on Mode
4	Print absolute path of artifact to stdout

Screenshot Flow (1 step)

#	Command
1	agent-browser snapshot to obtain accessibility tree
2	If the step contains operations, run agent-browser {click/type/fill/...}
3	agent-browser screenshot --full {outdir}/step-01.png

Video Flow (2+ steps)

#	Command
1	agent-browser record start {outdir}/capture.webm
2	For each step run snapshot then the operation in order
3	agent-browser record stop
4	ffmpeg -i {outdir}/capture.webm -vcodec libx264 {outdir}/capture.mp4

Insert agent-browser wait 500 between steps. Run snapshot before each operation to identify elements.

Output

Single stdout line:

mode=screenshot artifact=/absolute/path/to/step-01.png

or

mode=video artifact=/absolute/path/to/capture.mp4

On failure:

mode=failed reason=<one-line reason>