Agent skill · creative production · davila7
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.
Why this skill is useful
Adds executable scripts for capturing screenshots across different OS environments with specific parameters that the AI cannot generate on its own.
What it needs
Requires python3 installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.
What this skill does
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. To avoid multiple sandbox approval prompts, combine preflight + capture in one command when possible: For Codex inspection runs, keep the output in temp: Use the bundled scripts to avoid re-deriving OS-specific commands. macOS and Linux (Python helper) Run the helper from the repo root: Common patterns: Default location (user asked for "a screenshot"): Temp location (Codex visual check): Explicit location (user provided a path or filename): App/window capture by app name (macOS only; substring match is OK; captures all matching windows): Specific window title within an app (macOS only): List matching window ids before capturing (macOS only): Pixel region (x,y,w,h): Focused/active window (captures only the frontmost window; use --app to capture all windows): Specific window id (use --list-windows on macOS to discover ids): The script prints one path per capture. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills davila7/screenshot