Screengrab

这是基于macOS原生screencapture的轻量工具，无需浏览器即可捕获屏幕。核心功能包括单/多显示器快照、定时周期性捕获、自定义存储路径，支持直接在预览打开、静默输出路径供后续工具处理。典型用于调试视觉状态、检查运行应用、远程监控屏幕；不适合网页截图，仅支持macOS。通过命令行传参调用，输出为PNG图片或文件路径。

wrentheai

热度 51.48

最近更新 2026-05-11 17:33:34

分类：自动化依赖：代码执行应用场景：自动化脚本 / 调试排错

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add screengrab

Metadata

name: screengrab
description: Quick macOS display snapshot. Captures what's currently on screen without opening a browser. Saves to /tmp or a custom path. Supports multiple displays and periodic watch mode. USE WHEN: Agent needs to see what's on the Mac's screen right now — for debugging visual state, checking what app is open, verifying output, or remote awareness without a full browser session. Also use to list connected displays or capture a specific one. DON'T USE WHEN: User wants to screenshot a specific URL or web page (use browser snapshot instead). Not for headless/offscreen rendering.

screengrab

Thin wrapper around macOS screencapture. No dependencies beyond Python 3.

Requirements

macOS only (/usr/sbin/screencapture)
Script: scripts/screengrab.py

Commands

# Capture all displays → /tmp/screengrab-TIMESTAMP.png
python3 scripts/screengrab.py snap

# Custom output path
python3 scripts/screengrab.py snap --out ~/Desktop/snap.png

# Specific display (0=main, 1=second)
python3 scripts/screengrab.py snap --display 0

# Open in Preview immediately
python3 scripts/screengrab.py snap --open

# Quiet mode — just prints the file path (useful for piping to image tool)
python3 scripts/screengrab.py snap --quiet

# List connected displays
python3 scripts/screengrab.py list

# Periodic capture (every 30s)
python3 scripts/screengrab.py watch
python3 scripts/screengrab.py watch --interval 10 --out-dir ~/Desktop/snaps
python3 scripts/screengrab.py watch --count 5   # stop after N captures

Typical Agent Workflow

# Grab screen and analyze with image tool
path=$(python3 scripts/screengrab.py snap --quiet)
# Then pass $path to image analysis