Agent skill

peekaboo

macOS截图与视觉分析。自动截图、UI分析、窗口捕获。关键词: 截图, screenshot, 界面, UI, 看看, 显示, 样式, 报错弹窗, 视觉分析

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/peekaboo-codingsamss-all-my-ai-needs-3

SKILL.md

Peekaboo 视觉分析 Skill

通过peekaboo进行macOS截图和视觉分析，帮助调试UI问题。

截图保存目录

默认目录变量：

bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"

所有截图保存到: ${PEEKABOO_IMG_DIR}/

自动触发条件

当遇到以下情况时，主动使用peekaboo截图分析：

  • 用户描述UI/界面问题但未提供截图时
  • 调试前端/客户端代码遇到视觉相关bug时
  • 用户提到"看看"、"界面"、"显示"、"样式"、"报错弹窗"等词汇时
  • 命令执行后需要确认GUI状态时
  • 用户描述的问题可能通过视觉信息更容易理解时

截图策略

  • 默认使用 --mode frontmost 截取当前活动窗口
  • 用户提到具体应用时，使用 --app "应用名" 指定
  • 需要分析内容时，使用 --analyze "分析目标" 直接获取AI分析
  • 需要定位UI元素时，使用 --annotate 生成带标注的截图
  • 必须使用 --path 参数指定保存路径到 peekabooImg 目录

常用命令

截取当前窗口

bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截取指定应用

bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --app "IntelliJ IDEA" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Safari" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Terminal" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截图并AI分析

bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --analyze "描述界面内容"

列出所有窗口

bash
peekaboo list windows --json

截取指定标题窗口

bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --window-title "窗口标题" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

清理规则

重要：截图任务完成后，必须执行清理操作：

bash
# 清理截图文件
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
rm -f "${PEEKABOO_IMG_DIR}"/*.png

# 清理peekaboo快照缓存
peekaboo clean --all-snapshots 2>/dev/null || true

清理时机：

  • 截图分析完成并向用户反馈结果后
  • 用户明确表示不再需要截图时
  • 任务结束时

使用原则

  • 截图前简要说明原因
  • 优先截取相关窗口而非全屏
  • 分析结果要结合代码上下文给出建议
  • 任务完成后务必清理截图文件和缓存

前置条件

  1. peekaboo已安装: brew install steipete/tap/peekaboo
  2. 已授予屏幕录制权限: 系统设置 > 隐私与安全性 > 屏幕与系统音频录制

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results