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

pp-agent-capture — скилл для macOS: скриншоты

Скилл pp-agent-capture захватывает окна, записывает видео и конвертирует их в GIF прямо из терминала на macOS. Работает с конкретными приложениями благодаря ScreenCaptureKit, собирает доказательства для PR и мониторит изменения UI.

Apache-2.0 306 установок ★ 2 142 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mvanhorn/printing-press-library --skill pp-agent-capture -a claude-code
Открыть на GitHub

Что делает pp-agent-capture

Скилл управляет CLI agent-capture-pp-cli, который снимает экран по целевому окну или приложению, записывает видео, конвертирует видео в оптимизированные GIF, создаёт дифф против базовых скриншотов и собирает полные пакеты доказательств для PR. Внутри — ScreenCaptureKit для точного захвата на уровне окна (то, что не может ffmpeg), ffmpeg для конвертации, macOS Vision для OCR текста из окна.

Требует macOS и разрешения на запись экрана, которое скилл запросит при первом запуске. Бинарник устанавливается в $HOME/.local/bin (macOS/Linux) или %LOCALAPPDATA%\Programs\PrintingPress\bin (Windows) и должен быть доступен в $PATH. Если установка через npx не сработает, можно установить напрямую через Go (требуется 1.26.6 или новше).

Поддерживает множество команд: обычный screenshot и batch для нескольких окон, record для видео, pipeline для полного цикла за раз, diff для сравнения с базовым скриншотом, evidence для PR-пакета, find для поиска окна по названию, ocr для извлечения текста, watch для периодического мониторинга. Все команды работают с флагом --agent для машиночитаемого вывода JSON.

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

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

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

  • Сделай скриншот окна приложения Safari
  • Запиши видео последних 30 секунд экрана и сконвертируй в GIF
  • Собери пакет доказательств с до/после скриншотами и видео для PR

Как установить pp-agent-capture

1Через Skills CLI (Vercel)

npx skills add mvanhorn/printing-press-library --skill pp-agent-capture -a claude-code

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

~/.claude/skills/pp-agent-capture/SKILL.md

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

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

Вопросы о pp-agent-capture

Как установить pp-agent-capture в Claude Code?

Выполни в терминале npx skills add mvanhorn/printing-press-library --skill pp-agent-capture -a claude-code, потом проверь установку бинарника: agent-capture-pp-cli --version. Бинарник должен быть в $PATH.

Что делает pp-agent-capture?

Захватывает окна, записывает видео, конвертирует их в GIF, создаёт дифф скриншотов и собирает полные пакеты доказательств для PR. Использует ScreenCaptureKit для точного захвата на уровне окна, что ffmpeg не может делать.

На каких платформах работает pp-agent-capture?

Только на macOS — скилл использует ScreenCaptureKit. На других системах не будет работать.

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

SKILL.md · Apache-2.0
---
name: pp-agent-capture
description: "macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal. Built on ScreenCaptureKit for window-level targeting ffmpeg cannot do. Use when the user wants a screenshot of a specific window or app, a screen recording, a GIF conversion, a before/after diff, an evidence bundle for a PR, OCR text from a window, a terminal VHS recording, a Remotion render, or wants to watch a UI for changes. Requires macOS Screen Recording permission on first run."
author: "Matt Van Horn"
license: "Apache-2.0"
argument-hint: "<command> [args] | install cli"
allowed-tools: "Read Bash"
metadata:
  openclaw:
    requires:
      bins:
        - agent-capture-pp-cli
    install:
      - kind: go
        bins: [agent-capture-pp-cli]
        module: github.com/mvanhorn/printing-press-library/library/developer-tools/agent-capture/cmd/agent-capture-pp-cli
---
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/agent-capture/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Agent Capture - Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `agent-capture-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install agent-capture --cli-only
   ```
2. Verify: `agent-capture-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/agent-capture/cmd/agent-capture-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Reach for this when the user wants:

- screenshot a specific window or app (`screenshot`, `batch` for multiple)
- record video of a window, app, display, or region (`record`)
- convert a recording to an optimized GIF (`convert`)
- do a full capture + record + GIF pipeline in one command (`pipeline`)
- diff against a baseline screenshot (`diff`) for before/after evidence
- bundle screenshots + recording + GIF as evidence for a PR or bug report (`evidence`)
- find the right window by fuzzy-matching its title (`find`)
- stitch multiple screenshots into an animated GIF (`stitch`)
- extract text from a window using macOS Vision OCR (`ocr`)
- record a terminal session via VHS tape files (`vhs`)
- render Remotion compositions to video or stills (`remotion`)
- monitor a UI by periodic screenshots (`watch`)
- save and replay capture configs (`preset`)

Skip it on non-macOS hosts; the CLI uses ScreenCaptureKit (macOS only). On first run it will prompt for Screen Recording permission; the `permissions` command guides that flow.

## Argument Parsing

Parse `$ARGUMENTS`:

1. **Empty, `help`, or `--help`** -> show `agent-capture --help`
2. **Starts with `install`** -> CLI installation (no MCP server ships today)
3. **Anything else** -> Direct Use (map to the best command and run it)
## Direct Use

1. Check installed: `which agent-capture`. If missing, offer CLI installation.
2. If permissions aren't granted, run `agent-capture permissions` first.
3. Use `agent-capture list` to see available capture targets (open windows, displays).
4. Use `agent-capture find <text>` to fuzzy-match a window title before capturing.
5. Execute with `--json` for structured output (agent-native default):
   ```bash
   agent-capture <command> [args] --json
   ```

## Notable Commands

| Command | What it does |
|---------|--------------|
| `screenshot` | Capture a window, app, display, or region |
| `record` | Record video of a window, app, display, or region |
| `pipeline` | Record + convert + optimize in one command |
| `convert` | Video -> optimized GIF (two-pass palette) |
| `diff` | Capture + diff against a baseline |
| `evidence` | Full bundle (screenshots + recording + GIF) for a PR |
| `batch` | Screenshot multiple apps in one invocation |
| `find` | Fuzzy search open window titles |
| `list` | List available capture targets |
| `ocr` | Extract text from a window using macOS Vision |
| `stitch` | Combine screenshots into an animated GIF |
| `vhs` | Run a VHS tape file for terminal recording |
| `remotion` | Render Remotion compositions |
| `watch` | Periodic capture for UI monitoring |
| `preset` | Save / load capture configs |
| `permissions` | Guide Screen Recording permission setup |
| `health` | Machine-readable CI / agent preflight |

Run any command with `--help` for full flag documentation.

## Agent Mode

Add `--agent` to any command. Expands to: `--json --compact --no-input --no-color --yes`.

- **Pipeable** — JSON on stdout, errors on stderr
- **Filterable** — `--select` keeps a subset of fields, with dotted-path support (see below)
- **Previewable** — `--dry-run` shows the request without sending
- **Cacheable** — GET responses cached for 5 minutes, bypass with `--no-cache`
- **Non-interactive** — never prompts, every input is a flag


### Filtering output

`--select` accepts dotted paths to descend into nested responses; arrays traverse element-wise:

```bash
<cli>-pp-cli <command> --agent --select id,name
<cli>-pp-cli <command> --agent --select items.id,items.owner.name
```

Use this to narrow huge payloads to the fields you actually need — critical for deeply nested API responses.


## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Target not found (no matching window or display) |
| 4 | Permissions missing (Screen Recording not granted) |
| 5 | Capture error (ScreenCaptureKit failure, ffmpeg failure) |

© Matt Van Horn · Apache-2.0 · mvanhorn/printing-press-library

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
cmux-capture manaflow-ai Скилл cmux-capture помогает снять скриншот окна cmux или записать его в видео. Пригодится, чтобы показать визуальное изменение в PR или приложить доказательство к отчёту об ошибке. CX Codex +1 619установок capture-screen daymade Скилл capture-screen для программного захвата скриншотов на macOS: находит окна по ID, управляет видом через AppleScript и снимает кадр через screencapture. CX Codex +1 1 100установок Screenshot & PDF Capture — Full-Page Chromium Rendering axel-belfort Screenshot & PDF Capture — Full-Page Chromium Rendering — MCP-сервер для снимков веб-страниц через Chromium: сохраняет полные страницы в PNG, JPEG, WebP или PDF с настройкой viewport и эмуляцией устройств. CX Codex +1 4 295установок os-use zrong Скилл os-use для Claude Code, Cursor, Codex и других платформ: снимки экрана, управление мышью и клавиатурой, распознавание изображений, работа с окнами. Работает на macOS 12+ и Windows 10+. CX Codex +1 280установок openai-screenshot OpenAI Скилл openai-screenshot для Claude Code делает снимки рабочего стола, активных окон и выбранных областей экрана. Агент визуально проверяет интерфейс по снимкам. CX Codex +1 ★ 540звёзд репо screenshot openai Скилл screenshot делает снимок всего экрана, отдельного окна приложения или заданной области пикселей, когда агент не может снять нужное своей встроенной командой. CX Codex +1 119установок

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

Весь набор →
pp-slack Скилл pp-slack синхронизирует переписку Slack в локальную базу SQLite с полнотекстовым поиском, чтобы старые сообщения оставались доступны после истечения срока хранения. CX Codex +1 378установок pp-tesla Скилл pp-tesla для полного управления Tesla через CLI: проверка готовности авто, расчёт затрат на зарядку, мониторинг очереди на Supercharger и аудит ключей доступа. CX Codex +1 339установок pp-wanderlust-goat Скилл pp-wanderlust-goat для поиска мест, куда стоит дойти пешком: выдаёт 3–5 вариантов под ваш запрос вместо списка из сорока ближайших точек. CX Codex +1 335установок pp-openrouter Скилл pp-openrouter отслеживает расходы и остатки кредитов в OpenRouter через локальный лог. Помогает проверять бюджеты агентов и следить за сбоями провайдеров до запуска задач. CX Codex +1 328установок pp-docker-hub Скилл pp-docker-hub для Claude Code ищет публичные образы на Docker Hub и собирает метаданные репозиториев без браузера. Используется при подборе базовых контейнеров и проверке обновлений. CX Codex +1 295установок pp-sentry Скилл pp-sentry для управления Sentry через CLI: ищет инциденты, запрашивает проекты и выгружает данные в JSON для агентов. CX Codex +1 281установок pp-ebay Скилл pp-ebay для аналитики eBay: средняя цена проданных за 90 дней с отсечкой выбросов, поиск аукционов по числу ставок и времени до конца, локальная база для кросс-листингов. CX Codex +1 273установок pp-nvd Скилл pp-nvd для Claude Code ищет CVE в National Vulnerability Database по продукту, идентификатору или ключевым словам и показывает связанные оценки CVSS. Помогает проверить зависимость на уязвимости. CX Codex +1 271установок

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

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