Office & DocumentsIntermediate
screenshot
Capture desktop, app windows, or pixel regions across OS platforms
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/openai/skills --skill screenshotnpx skills add https://github.com/openai/skills --skill screenshotOr paste this URL into your assistant to install:
Overview
What This Skill Does
Capture desktop, app windows, or pixel regions across OS platforms
Application
When to use this Skill
- Integrating screenshot into your development workflow.
- Following best practices for capture desktop, app windows, or pixel regions across os platforms.
- Automating repetitive tasks with AI-assisted tooling.
- Building production-grade applications with proper standards.
- Debugging and troubleshooting common implementation issues.
Documentation
Show Skills.md file
Screenshot Capture
Follow these save-location rules every time:
- If the user specifies a path, save there.
- If the user asks for a screenshot without a path, save to the OS default screenshot location.
- If Codex needs a screenshot for its own inspection, save to the temp directory.
Tool priority
- Prefer tool-specific screenshot capabilities when available (for example: a Figma MCP/skill for Figma files, or Playwright/agent-browser tools for browsers and Electron apps).
- Use this skill when explicitly asked, for whole-system desktop captures, or when a tool-specific capture cannot get what you need.
- Otherwise, treat this skill as the default for desktop apps without a better-integrated capture tool.
macOS permission preflight (reduce repeated prompts)
On macOS, run the preflight helper once before window/app capture. It checks Screen Recording permission, explains why it is needed, and requests it in one place.
The helpers route Swift's module cache to $TMPDIR/codex-swift-module-cache
to avoid extra sandbox module-cache prompts.
bash <path-to-skill>/scripts/ensure_macos_permissions.sh
Lines 1 - 26 of 261
Recommendations