screenshot
作者 openai這個 screenshot 技能可在你需要 OS 層級影像，而不是僅限瀏覽器擷取時，用來擷取全螢幕、應用程式視窗或像素區域。適用於 Workflow Automation 中的 screenshot 使用情境，包含儲存位置規則、macOS 權限處理，以及清楚的安裝指引，讓桌面擷取更可靠。
這個技能評分為 78/100，對於需要可靠 screenshot 擷取指引的目錄使用者來說，是一個相當穩妥的收錄候選。其儲存庫明確說明適用情境，提供 macOS 與跨平台擷取的操作腳本，並附有可降低試錯成本的前置檢查；不過，若要更利於安裝決策，仍會希望有更清楚的快速入門與明確的安裝指令。
- 觸發條件明確：當使用者要求桌面／系統截圖，或工具本身無法擷取時，就適合使用。
- 操作細節扎實：提供 macOS、Windows 與 Python 擷取的專用腳本，並加入 macOS 權限前檢查，以減少反覆提示。
- 對代理人很有幫助：技能清楚定義儲存位置規則與工具優先順序，能讓代理人更少歧義地選擇合適的擷取路徑。
- SKILL.md 中沒有安裝指令，因此採用者可能需要自行推斷設定方式，而不是直接照著單一步驟安裝流程操作。
- 這段內容在操作機制上很完整，但部分平台相關的執行細節仍交由腳本處理；遇到邊界情況時，可能需要進一步檢視腳本。
screenshot skill 概覽
screenshot skill 的用途
screenshot skill 可協助代理在需要整個螢幕、特定視窗、應用程式區域，或已儲存檔案路徑時，擷取正確的桌面影像。當你需要的是實際的作業系統層級截圖，而不是僅限瀏覽器的擷取、設計工具截圖，或一般性的提示回覆時，它才是合適的選擇。
什麼情況下適合安裝 screenshot skill
如果你的工作流程包含桌面應用程式、多視窗檢視、作業系統介面除錯，或工具本身無法提供擷取功能的情境，就應該安裝 screenshot。對於需要視覺佐證、交付產物，或像素精準參考的 Workflow Automation 工作，它尤其實用。
screenshot skill 的差異
這個 screenshot skill 是以決策為導向，不只是單純的命令包裝器。它內建擷取優先順序、儲存位置規則，以及 macOS 權限處理方式，讓代理能更快選到可行路徑、也更少反覆詢問。當使用者只說「截圖」或給了不完整的目標時，這能大幅減少猜測。
如何使用 screenshot skill
安裝並找到核心檔案
使用 npx skills add openai/skills --skill screenshot 安裝。接著先讀 SKILL.md，再看 scripts/take_screenshot.py、scripts/ensure_macos_permissions.sh，以及 agents/openai.yaml。如果你需要了解平台差異行為，在假設擷取路徑之前，先檢查 scripts/ 裡的 Swift 輔助程式。
提供完整的擷取需求
一個有效的 screenshot 使用需求，至少要說清楚四件事：目標、範圍、輸出路徑，以及限制條件。例子如：「擷取目前作用中的 Photoshop 視窗並儲存到 /tmp/review.png」或「截取第 2 個顯示器的全螢幕畫面，存到預設截圖資料夾。」如果沒有指定路徑，skill 會依作業系統預設處理；如果 Codex 需要影像進行檢視，則應儲存到暫存位置。
依平台選對工作流程
對於瀏覽器、Figma 或 Electron，應優先使用它們原生或工具專屬的截圖路徑。只有在你需要整個桌面、應用程式／視窗擷取才是實際需求，或其他工具無法擷取重點內容時，才使用這個 skill。在 macOS 上，進行視窗／應用程式擷取前先跑過權限預檢，可避免反覆跳出 Screen Recording 提示。
實用的提示詞模式
好的 screenshot 指令要夠具體，才能觸發正確的 helper 與輸出。例子：「使用 screenshot skill 擷取 macOS 上編輯器視窗的左半部，然後存到預設截圖位置。」如果你需要區域擷取，請用 x,y,w,h 格式提供座標，並說明該區域是相對於螢幕，還是相對於某個視窗。
screenshot skill 常見問題
screenshot skill 只適合全螢幕擷取嗎？
不是。screenshot skill 支援全螢幕、視窗、應用程式與區域擷取。只有在整個桌面情境都很重要時才用全螢幕；否則應縮小目標，以降低雜訊、提升實用性。
什麼情況下不該使用這個 skill？
如果有更整合的工具能直接擷取你要的那個介面，像是 Figma 或瀏覽器專屬流程，就不要用 screenshot。若你的目標是文字擷取或 UI 推理，而且不需要真正的影像產物，也不適合使用它。
新手需要先懂作業系統細節嗎？
不需要。新手可以直接說「幫我截這個視窗」。真正能提升成功率的，是補上目標、儲存路徑，以及任何裁切細節。在 macOS 上，權限仍可能是主要阻礙，所以請預期需要一個設定步驟。
這和一般提示詞有什麼不同？
一般提示詞可能只描述想要的畫面，但 screenshot skill 還會處理擷取方式、儲存位置規則，以及 macOS 權限摩擦。這讓它在 Workflow Automation 裡更可靠，因為代理會被導向具體的檔案輸出，而不是抽象回答。
如何改善 screenshot skill
盡可能把目標講得最明確
影像品質提升最大的關鍵，就是直接點名畫面中應該出現什麼。比起「截取編輯器」，「截取顯示 app.py、且終端機可見的 VS Code 視窗」明確得多。目標越具體，就越能減少擷取失敗，尤其是在同時開著多個相似視窗時。
補上會改變結果的限制條件
如果截圖必須排除私人內容、只保留單一螢幕，或要呈現特定解析度，請一開始就說明。若是區域擷取，也要提供座標，並註明裁切範圍是否要包含視窗外框、標題列，或只保留內容本身。這些細節比多寫幾句形容更重要。
用第一次輸出修正下一次
如果截圖太大、太小，或漏掉關鍵 UI 狀態，就根據問題收斂目標並迭代。例如：「重拍，只保留彈出視窗可見的部分」或「把裁切往下移，包含狀態列。」這種回饋循環，是改善 screenshot 使用方式最快的方法。
注意常見失敗模式
最常見的問題是 macOS 權限提示、截錯螢幕，以及在其實有更好工具可用時，仍要求截圖。若第一次擷取失敗，請補上應用程式名稱、視窗標題、螢幕編號，或精確區域來改進需求。