# screenshot

Takes a picture of the whole screen, a single app window or a pixel region when the agent has no built-in capture route for the task.

- skill · `type=skill` · Claude Code · 119 installs
- Author: openai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/media/screenshot
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/screenshot

## What it does

The skill kicks in on an explicit request for a desktop screenshot, or when the tool you are working with cannot grab the screen itself. For browsers and Electron apps the author points to Playwright or agent-browser first, and Figma files go through a Figma MCP server. This one covers plain desktop apps that lack a better capture path.

Two helpers do the work: `take_screenshot.py` on macOS and Linux, `take_screenshot.ps1` on Windows. The Python version handles a full-screen grab, a `--region x,y,w,h` box, the frontmost window, and app name lookup with an optional window title filter — those last two are macOS only. Where the file lands follows three rules: your own path if you gave one, the OS screenshot folder if not, and temp when the agent needs the image for itself.

On macOS, capturing a window or app requires Screen Recording access, so the helper is run through `ensure_macos_permissions.sh`. The Linux helper picks the first tool it finds among `scrot`, `gnome-screenshot` and ImageMagick `import`. Without one of them the capture fails, so install one before you rely on it.

Raw OS examples with `screencapture`, `scrot` and `gnome-screenshot` are included as fallbacks. Python 3 or PowerShell is needed, depending on the system.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill media/screenshot
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill screenshot -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/screenshot/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/screenshot/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/screenshot/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/screenshot/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates screenshot
```

2. **Manually: put the files in place**
- File: `.github/skills/screenshot/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/media/screenshot
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/screenshot/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/media/screenshot

## When to use it
- take a full-screen shot into a given file
- grab one app window by its name
- cut out a rectangular pixel area
- feed the agent a screenshot for a visual check
- compare a live UI against a design capture

## Example prompts
- Take a screenshot of my screen and save it to `output/screen.png`
- Capture the Claude app window and tell me what is on it
- Screenshot region 100,200,800,600 into the temp folder

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

## Other versions with the same name
- [screenshot · nexu-io](https://affpapa.org/en/nevibecode/skills/nexu-io-screenshot.md) — 2700 installs
- [screenshot · bobmatnyc](https://affpapa.org/en/nevibecode/skills/bobmatnyc-screenshot.md) — 380 installs
- [screenshot · zernie](https://affpapa.org/en/nevibecode/skills/zernie-screenshot.md) — 337 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md