当你需要记录桌面 App 的错误状态、给同事说明操作位置，或让 Codex 检查屏幕上的布局时，screenshot 提供系统级截图流程。你可以明确指定整屏、前台窗口或像素区域。它处理的是实际可访问的桌面画面，交付应包含已保存的图片与路径；只有文字描述不算截图完成。
安装与准备
本文介绍 openai/skills 保留的独立 Skill 版本。该仓库已弃用，当前官方示例转至 openai/plugins；这里的步骤对应本页链接的旧仓库版本，不代表最新插件。
在 Codex 对话框输入下面这一行；它不是终端命令。安装后若找不到该 Skill，重启 Codex 再试。
$skill-installer screenshot
- Codex 能访问有图形桌面的本机运行环境
- 目标 App 已打开，待记录内容可见
- macOS/Linux 辅助脚本使用 Python 3；Windows 使用 PowerShell
- macOS 需要屏幕录制权限；Linux 需要 scrot、gnome-screenshot 或 ImageMagick import 之一
macOS 上若权限检查失败，在“系统设置 → 隐私与安全性 → 屏幕与系统音频录制”中检查运行截图的 App 权限；设置名称可能随系统版本变化。权限由用户在系统中管理，Skill 不能绕过。 [4]
第一次怎么用
将目标窗口置前，可以这样要求保存截图：
$screenshot
截取我当前已置于前台的应用窗口，保存到 output/screenshots/current-window.png。先确认操作系统和可用截图方式，避免误截整个桌面。完成后打开实际保存的图片，检查窗口标题与内容是否正确，并给出文件路径。如果没有桌面会话、缺少权限或窗口不可见，请说明具体阻碍，不要声称已经截图。
接下来怎样推进
-
说清对象与保存位置。 给出整屏、前台窗口或 x、y、宽、高像素区域，并指定文件名。有明确路径就保存到那里；用户未给路径时用系统默认截图位置，Codex 自己检查时用临时目录。
-
选择适合平台的方式。 macOS 可以按 App 名称、窗口标题或窗口 ID 定位；按 App 名称匹配可能截到多个窗口。Linux 不能照搬这些 App 名参数；Windows 使用 PowerShell 辅助脚本，截前台窗口前先把目标窗口置前。
-
打开图片核对结果。 逐个查看脚本返回的文件，确认目标、范围、内容与清晰度。macOS 多显示器整屏截图可产生多个文件；Linux 和 Windows 通常把虚拟桌面保存为一张图，需要单屏时指定区域。
先选对截图对象
网页或 Figma 这类工具如果自带截图能力，优先用对应工具截目标页面；本 Skill 适合需要记录整个桌面、某个原生 App 窗口或指定像素区域时使用。请求里写清“哪块屏幕、哪个窗口、保存到哪里”。例如：“截取当前前台应用窗口，保存为 artifacts/settings-before.png；先让我确认窗口内容，避免把旁边显示器和私人通知一起截进去。”
macOS 首次使用可能需要授予屏幕录制权限；授予后若仍是黑屏，应确认正在运行的 Codex 进程是否拥有权限，并重新尝试。按 App 名称匹配可能返回多个窗口；需要精确定位时先列出窗口，再选 ID。Linux 的依赖是可用的图形会话及截图程序，不能直接使用 macOS 的窗口名选项。
看图而不只看文件名
脚本返回路径后，应真正打开每张图，确认目标完整可见、没有被弹窗遮挡，文字可以辨认，像素范围符合任务。多显示器的整屏截取可能产生多张文件；交付时逐一说明用途。截图只是某一时刻的画面证据，若任务是“验证按钮能用”，仍需另做点击和状态检查。
交付后先检查什么
交付应包含真实截图文件及可定位的路径。检查是否截错窗口、切掉关键文字，或把其他屏幕一并收入；多文件输出要逐一确认。若目的是比较设计与实现，应保留原始截图，再说明观察到的差异，不把后续裁剪或标注当作原始画面。
先用无敏感内容的窗口试截
第一次在新机器上使用时，先对一个没有私人信息的窗口试截一张，并打开文件确认目标、清晰度和保存目录。之后再截真实故障画面，先收起通知、令牌与客户资料；要分享给别人时，用区域或指定窗口缩小范围。独立静态评估也提醒，这个 Skill 的跨平台说明不等于每个平台都已经有公开运行记录，因此不要仅凭命令返回文件名就把截图交付出去。
常见卡点
macOS 没有匹配窗口。 确认 App 可见，先列出匹配窗口，再用明确窗口 ID 重试；名字相似或多个窗口同时打开时尤其需要这一步。
Linux 无法截图或裁切。 检查截图工具是否可用。区域截图需要 scrot 或 ImageMagick import；仅有 gnome-screenshot 不满足该辅助脚本的区域要求。
图片空白或环境没有桌面。 说明缺少的桌面会话或系统权限，恢复这些条件后再截；文件名存在并不能证明捕获到了内容。
浏览器页面或 Figma 画面不完整。 优先用对应工具自带的截图能力，需要桌面上下文时再用系统截图。整屏截取不会自动得到完整长网页。