screenshot
Use when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are unavailable and an OS-level capture is needed.
npx skills add Haohao-end/openagent --skill screenshot --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Screenshot Capture Follow these save-location rules every time: 1) If the user specifies a path, save there. 2) If the user asks for a screenshot without a path, save to the OS default screenshot location. 3) 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 bash <path-to-skill>/scripts/ensure_macos_permissions.sh ``` To avoid multiple sandbox approval prompts, combine preflight + cap
- Tool priority
- macOS permission preflight (reduce repeated prompts)
- macOS and Linux (Python helper)
- Workflow examples
- Multi-display behavior
- Linux prerequisites and selection logic
- Windows (PowerShell helper)
- Direct OS commands (fallbacks)
- macOS
- Linux
- Error handling
bash <path-to-skill>/scripts/ensure_macos_permissions.sh bash <path-to-skill>/scripts/ensure_macos_permissions.sh && \ python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" python3 <path-to-skill>/scripts/take_screenshot.py --app "<App>" --mode temp python3 <path-to-skill>/scripts/take_screenshot.py python3 <path-to-skill>/scripts/take_screenshot.py --mode temp python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" --window-name "Settings" python3 <path-to-skill>/scripts/take_screenshot.py --list-windows --app "Codex" python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600
What does the screenshot skill do?
Use when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are unavailable and an OS-level capture is needed.
How do I install it?
Run `npx skills add Haohao-end/openagent --skill screenshot --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Haohao-end/openagent, a repository with 778 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.