| name | screenshot |
| description | Take screenshots from the terminal using the screenshot CLI tool. Use this skill when the user wants to capture the screen or a region, save screenshots to files, or integrate screenshot capture into scripts. Supports cross-platform (Windows/macOS/Linux) with automatic fallback to native tools.
|
Screenshot Skill
Take screenshots from the terminal.
Installation Check
screenshot --help
If not installed:
uv tool install "git+https://github.com/lirrensi/agent-sommelier"
Usage
Auto-named Screenshot
screenshot
Named Screenshot
screenshot output.png
screenshot /path/to/screenshot.png
Output
The command outputs the path to the saved screenshot, making it easy to use in scripts:
screenshot | xargs open
screenshot | xargs curl -F "image=@-" http://api/upload
SCREENSHOT=$(screenshot)
echo "Saved to: $SCREENSHOT"
Examples
screenshot
screenshot ~/Desktop/bug_report.png
screenshot "/tmp/screenshot_$(date +%s).png"
notify "Screenshot" "$(screenshot)"
Platform Support
Uses the mss library for cross-platform screenshots:
- Windows: Direct screen capture
- macOS: Direct screen capture
- Linux: Direct screen capture (X11/Wayland)
If mss is not available, falls back to native tools:
- Linux: gnome-screenshot, scrot, import, flameshot
- macOS: screencapture
- Windows: PowerShell with .NET