| name | photograph |
| description | Captures visual snapshots (screenshots) of web pages and records screen sessions (video). |
📸 Photograph Skill (formerly Screenshot Taker)
The Photograph skill allows the toolkit to capture visual snapshots of web pages and record screen activity. This is useful for archiving dataset sources, verifying page content, recording process execution for proof-of-work, or feeding visual data into Gemini's multimodal reasoning engine.
Features
- High-Quality Screenshots: Capture web pages using Playwright (High-Fidelity).
- Screen Recording: Record the entire screen (macOS) while a specific process is running.
- Headless Mode: Captured quietly in the background (default for screenshots).
- Auto-Consent Handling: Automatically handles "Accept Cookies" popups.
- Process Sync: Video recording automatically starts before a command and stops when it finishes.
Setup
This skill requires playwright and ffmpeg. Run the following commands to set it up:
pip install playwright
playwright install chromium
brew install ffmpeg
Usage
1. Screenshots
Capture a web page. You can capture a single snapshot or two snapshots (Begin/End) to see how the page evolves (e.g., after popups are handled).
python3 .gemini/skills/photograph/scripts/take_screenshot.py "https://mlcommons.org/croissant"
python3 .gemini/skills/photograph/scripts/take_screenshot.py "https://google.com" --dual-state --delay 12
2. Screen Recording (New!)
Record the screen while a specific command is being executed. The recording will automatically stop when the command completes.
python3 .gemini/skills/photograph/scripts/record_screen.py --command "python3 main.py run" --output demo.mp4
3. Fixed Duration Recording
Record the screen for 10 seconds.
python3 .gemini/skills/photograph/scripts/record_screen.py --duration 10 --output short_clip.mp4
4. Advanced Recording (New!)
Record a specific screen with audio, or list available devices.
python3 .gemini/skills/photograph/scripts/record_screen.py --list-devices
python3 .gemini/skills/photograph/scripts/record_screen.py --screen 2 --audio --duration 5 --output multiscreen.mp4
Integration
This skill can be used by the Orchestrator to visually verify pages or provide a video log of long-running data integration processes.