К основному содержанию
скилл CX Codex

openai-screenshot — скилл для Claude Code: что делает и как установить

Скилл openai-screenshot для Claude Code делает снимки рабочего стола, активных окон и выбранных областей экрана. Агент визуально проверяет интерфейс по снимкам.

Apache-2.0 ★ 540 обновлён 2026-07-14

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add trailofbits/skills-curated
/plugin install openai-screenshot@skills-curated
Открыть на GitHub

Что делает openai-screenshot

Скилл запускает готовые скрипты автоматизации для захвата экрана в macOS, Linux и Windows. Он определяет границы окон, считывает координаты регионов и сохраняет файлы во временный каталог или по указанному пути. В macOS поддерживается поиск окон по названию программы или заголовку, а при нескольких мониторах утилита сохраняет отдельное изображение для каждого дисплея.

Внутри используются Python-скрипт take_screenshot.py и PowerShell-скрипт take_screenshot.ps1. Если запустить скрипты напрямую невозможно, агент переходит на системные утилиты вроде screencapture в macOS либо scrot, gnome-screenshot или ImageMagick import в Linux.

В Linux без установленных scrot, gnome-screenshot или пакета ImageMagick захват завершится ошибкой.

Какие задачи решает

  • снять скриншот всего экрана или виртуального рабочего стола
  • захватить окно конкретного приложения по его названию в macOS
  • сохранить прямоугольную область экрана по координатам в пикселях
  • сохранить снимок интерфейса во временную папку для анализа моделью

Примеры запросов агенту

  • Сделай скриншот активного окна и сохрани его во временную папку
  • Сними окно приложения Settings и положи файл в output/screen.png
  • Захвати область экрана с координатами 100,200,800,600 для проверки вёрстки

Как установить openai-screenshot

1Через маркетплейс плагинов

/plugin marketplace add trailofbits/skills-curated
/plugin install openai-screenshot@skills-curated

Команда ставит плагин openai-screenshot целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add trailofbits/skills-curated --skill openai-screenshot -a claude-code

3Вручную: положить файлы

~/.claude/skills/openai-screenshot/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/openai-screenshot/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об openai-screenshot

Как установить openai-screenshot в Claude Code?

Подключите каталог и поставьте плагин двумя командами: /plugin marketplace add trailofbits/skills-curated, а затем /plugin install openai-screenshot@skills-curated.

Что делает скилл openai-screenshot?

Он даёт агенту инструкции и готовые скрипты для снятия скриншотов рабочего стола, отдельных окон или фрагментов экрана по координатам.

Какие системные пакеты требуются для работы в Linux?

Скрипт проверяет наличие scrot, gnome-screenshot или ImageMagick import. Захват произвольного региона пикселей работает только через scrot или import.

Исходный текст

SKILL.md · Apache-2.0
---
name: openai-screenshot
description: 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. Originally from OpenAI's curated skills catalog.
allowed-tools:
- Bash
- Read
- Grep
- Glob
- Write
- Edit
---

# 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 the agent 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 {baseDir}/scripts/ensure_macos_permissions.sh
```

To avoid multiple sandbox approval prompts, combine preflight + capture in one
command when possible:

```bash
bash {baseDir}/scripts/ensure_macos_permissions.sh && \
python3 {baseDir}/scripts/take_screenshot.py --app "the agent"
```

For the agent inspection runs, keep the output in temp:

```bash
bash {baseDir}/scripts/ensure_macos_permissions.sh && \
python3 {baseDir}/scripts/take_screenshot.py --app "<App>" --mode temp
```

Use the bundled scripts to avoid re-deriving OS-specific commands.

## macOS and Linux (Python helper)

Run the helper from the repo root:

```bash
python3 {baseDir}/scripts/take_screenshot.py
```

Common patterns:

- Default location (user asked for "a screenshot"):

```bash
python3 {baseDir}/scripts/take_screenshot.py
```

- Temp location (the agent visual check):

```bash
python3 {baseDir}/scripts/take_screenshot.py --mode temp
```

- Explicit location (user provided a path or filename):

```bash
python3 {baseDir}/scripts/take_screenshot.py --path output/screen.png
```

- App/window capture by app name (macOS only; substring match is OK; captures all matching windows):

```bash
python3 {baseDir}/scripts/take_screenshot.py --app "the agent"
```

- Specific window title within an app (macOS only):

```bash
python3 {baseDir}/scripts/take_screenshot.py --app "the agent" --window-name "Settings"
```

- List matching window ids before capturing (macOS only):

```bash
python3 {baseDir}/scripts/take_screenshot.py --list-windows --app "the agent"
```

- Pixel region (x,y,w,h):

```bash
python3 {baseDir}/scripts/take_screenshot.py --mode temp --region 100,200,800,600
```

- Focused/active window (captures only the frontmost window; use `--app` to capture all windows):

```bash
python3 {baseDir}/scripts/take_screenshot.py --mode temp --active-window
```

- Specific window id (use --list-windows on macOS to discover ids):

```bash
python3 {baseDir}/scripts/take_screenshot.py --window-id 12345
```

The script prints one path per capture. When multiple windows or displays match, it prints multiple paths (one per line) and adds suffixes like `-w<windowId>` or `-d<display>`. View each path sequentially with the image viewer tool, and only manipulate images if needed or requested.

### Workflow examples

- "Take a look at <App> and tell me what you see": capture to temp, then view each printed path in order.

```bash
bash {baseDir}/scripts/ensure_macos_permissions.sh && \
python3 {baseDir}/scripts/take_screenshot.py --app "<App>" --mode temp
```

- "The design from Figma is not matching what is implemented": use a Figma MCP/skill to capture the design first, then capture the running app with this skill (typically to temp) and compare the raw screenshots before any manipulation.

### Multi-display behavior

- On macOS, full-screen captures save one file per display when multiple monitors are connected.
- On Linux and Windows, full-screen captures use the virtual desktop (all monitors in one image); use `--region` to isolate a single display when needed.

### Linux prerequisites and selection logic

The helper automatically selects the first available tool:

1) `scrot`
2) `gnome-screenshot`
3) ImageMagick `import`

If none are available, ask the user to install one of them and retry.

Coordinate regions require `scrot` or ImageMagick `import`.

`--app`, `--window-name`, and `--list-windows` are macOS-only. On Linux, use
`--active-window` or provide `--window-id` when available.

## Windows (PowerShell helper)

Run the PowerShell helper:

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1
```

Common patterns:

- Default location:

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1
```

- Temp location (the agent visual check):

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1 -Mode temp
```

- Explicit path:

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1 -Path "C:\Temp\screen.png"
```

- Pixel region (x,y,w,h):

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1 -Mode temp -Region 100,200,800,600
```

- Active window (ask the user to focus it first):

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1 -Mode temp -ActiveWindow
```

- Specific window handle (only when provided):

```powershell
powershell -ExecutionPolicy Bypass -File {baseDir}/scripts/take_screenshot.ps1 -WindowHandle 123456
```

## Direct OS commands (fallbacks)

Use these when you cannot run the helpers.

### macOS

- Full screen to a specific path:

```bash
screencapture -x output/screen.png
```

- Pixel region:

```bash
screencapture -x -R100,200,800,600 output/region.png
```

- Specific window id:

```bash
screencapture -x -l12345 output/window.png
```

- Interactive selection or window pick:

```bash
screencapture -x -i output/interactive.png
```

### Linux

- Full screen:

```bash
scrot output/screen.png
```

```bash
gnome-screenshot -f output/screen.png
```

```bash
import -window root output/screen.png
```

- Pixel region:

```bash
scrot -a 100,200,800,600 output/region.png
```

```bash
import -window root -crop 800x600+100+200 output/region.png
```

- Active window:

```bash
scrot -u output/window.png
```

```bash
gnome-screenshot -w -f output/window.png
```

## Error handling

- On macOS, run `bash {baseDir}/scripts/ensure_macos_permissions.sh` first to request Screen Recording in one place.
- If you see "screen capture checks are blocked in the sandbox", "could not create image from display", or Swift `ModuleCache` permission errors in a sandboxed run, rerun the command with escalated permissions.
- If macOS app/window capture returns no matches, run `--list-windows --app "AppName"` and retry with `--window-id`, and make sure the app is visible on screen.
- If Linux region/window capture fails, check tool availability with `command -v scrot`, `command -v gnome-screenshot`, and `command -v import`.
- If saving to the OS default location fails with permission errors in a sandbox, rerun the command with escalated permissions.
- Always report the saved file path in the response.

## When to Use

<!-- TODO: review -->

## When NOT to Use

<!-- TODO: review -->

© OpenAI · Apache-2.0 · trailofbits/skills-curated

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
screenshot openai Скилл screenshot делает снимок всего экрана, отдельного окна приложения или заданной области пикселей, когда агент не может снять нужное своей встроенной командой. CX Codex +1 119установок os-use zrong Скилл os-use для Claude Code, Cursor, Codex и других платформ: снимки экрана, управление мышью и клавиатурой, распознавание изображений, работа с окнами. Работает на macOS 12+ и Windows 10+. CX Codex +1 280установок capso-screenshot-macos reason-machines Скилл capso-screenshot-macos по Capso — открытому приложению для снимков экрана и записи на macOS. Помогает встроить его SPM-пакеты в свой проект. CX Codex +1 452установок bash-linux davila7 Скилл bash-linux для Claude Code — справочник по Bash в macOS и Linux: команды, файлы, процессы и обработка ошибок. Помогает править скрипты и разбирать логи. CX Codex +1 215установок Cross-Platform Build Expert JARVIS AI Assistant Скилл Cross-Platform Build Expert помогает настроить сборку десктопных приложений на Tauri под Windows, macOS и Linux, включая подпись кода и CI/CD. CX Codex +1 210установок browser-screenshot-diff ruvnet Скилл browser-screenshot-diff для Claude Code сравнивает скриншоты и DOM двух записанных браузерных сессий на одинаковых шагах, выявляя первое расхождение и общую похожесть. CX Codex +1 697установок

Из того же набора51

Весь набор →
scv-scan Скилл scv-scan для Claude Code ищет уязвимости в Solidity-контрактах. Агент подключает его для проверки проекта перед выпуском или после правок. CX Codex +1 ★ 540звёзд репо review-plugin Команда review-plugin проверяет каталог плагина на ошибки в скриптах и соответствие стандартам проекта, сразу исправляя найденные дефекты. CX Codex +1 ★ 540звёзд репо x-research Скилл x-research для Claude Code ищет свежие обсуждения в X, открывает треды и собирает источники в сводку. По ним можно узнать реакцию разработчиков на выпуск библиотеки или изменение API. CX Codex +1 ★ 540звёзд репо skill-extractor Скилл skill-extractor разбирает рабочую сессию и превращает найденное решение в скилл для Claude: причину ошибки, обходной путь, условия срабатывания. CX Codex +1 ★ 540звёзд репо openai-develop-web-game Скилл openai-develop-web-game направляет агента при разработке браузерных игр на HTML и JavaScript через пошаговый цикл с тестами в Playwright. CX Codex +1 ★ 540звёзд репо writing-great-skills Скилл writing-great-skills для Claude Code создаёт, проверяет и сокращает SKILL.md, чтобы агент следовал понятному процессу. Помогает разбирать нестабильную работу навыка и избыточные инструкции. CX Codex +1 ★ 540звёзд репо import-skill Команда import-skill переносит скиллы из сторонних репозиториев GitHub в каталог плагинов Claude Code: скачивает дерево, адаптирует пути и разметку. CX Codex +1 ★ 540звёзд репо wooyun-legacy Скилл wooyun-legacy разбирает веб-уязвимости и логические бреши по методологии базы WooYun. Пригодится на пентестах, аудитах кода и проверке систем авторизации. CX Codex +1 ★ 540звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой