SkillFoxx
Telegram

SC Skill

Скилл помогает агенту снимать окна macOS для тестов и документации: выбирать размеры и инструмент, сохранять файлы

  • 945 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Скрипты управляют окнами и по умолчанию закрывают окна целевого приложения
  • Снимки могут включать секреты, документы и данные открытой сессии
Все причины и проверки

jazzyalex/agent-sessionsАвтор:jazzyalex

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/sc-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Скрипты управляют окнами и по умолчанию закрывают окна целевого приложения
  • Снимки могут включать секреты, документы и данные открытой сессии

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

SC Skill задает агенту порядок подготовки снимков приложений на Mac. Скрипт сначала приводит окно к выбранным размерам и положению, затем сохраняет изображение. Режимы `testing` и `marketing` задают разные параметры оформления и максимального размера файла. Для съемки скилл выбирает Peekaboo, если он установлен и получил разрешения. В другом случае доступен штатный `screencapture`. Агент может явно выбрать инструмент, путь вывода и размер изображения, а также включить отдельный JSON-файл с метаданными. Через `--app` можно выбрать целевое приложение. Часть проверок готовности окна предназначена для AgentSessions. Для других приложений одинаковые размеры окна помогают повторить композицию, но не гарантируют одинакового содержимого снимка.

Для кого. Тестировщикам macOS-приложений, которые поручают агенту подготовить снимки окон для проверок или документации.

Подходит, если

  • Нужно снять несколько экранов приложения с одинаковым положением окна
  • Для инструкции требуется изображение с заранее выбранным именем файла
  • Нужно выбрать между установленным Peekaboo и штатным инструментом macOS
  • Вместе со снимком нужно сохранить сведения о выбранном режиме и области

Не подходит, если

  • Нужны снимки приложения на Windows или Linux
  • Нельзя активировать, перемещать или закрывать окна пользователя
  • Требуется автоматическое доказательство отсутствия визуальных ошибок

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

Прочитай SC Skill и подготовь команду снимка моего приложения в режиме `testing`. Сначала покажи команду без съемки. Окна после съемки оставь открытыми, изображение сохрани в `artifacts/screenshots/settings.png`.

Ограничения

Скрипты рассчитаны на macOS с Bash и AppleScript; дополнительная обработка изображений может требовать Python и Pillow. Для Peekaboo нужны Screen Recording и Accessibility, а управление окнами зависит от разрешений macOS. Одиночная съемка по умолчанию активирует приложение, меняет положение окна и закрывает его окна после сохранения: сначала сохраните документы. Снимок может содержать секреты, которые не проверяются по имени файла или повторяемым размерам окна.

Как отключить. Удалите подключение SC Skill из каталога скиллов агента и остановите запущенный скрипт. При необходимости отзовите разрешения съемки и Accessibility. Сохраненные изображения и файлы метаданных удаляются отдельно.

Частые вопросы

Что нужно установить?

Используйте каталог `skills/sc-skill` целиком. Это скилл со скриптами для снимков, установка настольного приложения Agent Sessions для общего режима съемки не требуется.

Как посмотреть команду без съемки?

Добавьте `--dry-run` к вызову `sc_capture.sh`. Скрипт выведет выбранную команду. Это помогает проверить параметры, но не подтверждает, что система разрешит съемку при настоящем запуске.

Как сохранить окна открытыми?

Для одиночного снимка укажите `--no-close-window`. Без него скрипт после съемки пытается закрыть окна целевого приложения. Не запускайте режим закрытия поверх несохраненных документов.

В чем различаются режимы?

Размером изображения и настройками окна. При `--max-edge auto` режим `testing` ограничивает длинную сторону 1800 пикселями, `marketing` — 2560. Проверяйте визуальные ошибки в приложении отдельно.

Нужен ли Peekaboo?

Нет, можно выбрать `--tool native`. В режиме `auto` Peekaboo используется при наличии программы и нужных разрешений, иначе доступна штатная съемка macOS.

Какая лицензия у SC Skill?

MIT.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл помогает агенту разбирать запись экрана Scrawl по кадрам, голосовому пояснению и нарисованным отметкам пользователя.

СкиллРасширенный доступ913

Скриншоты веб-страниц для агента: локальный MCP-сервер и CLI на вашем Chrome, маскировка секретов до записи пикселей

MCP-серверРасширенный доступ93

Caliper прогоняет задачи агента с вашим скиллом и без него и показывает, помогает ли скилл и сколько токенов он стоит

CLIРасширенный доступ232
Официальный

Скиллы Midscene управляют браузером, ПК, Android, iOS и HarmonyOS по скриншотам и пишут E2E-тесты на Vitest через Claude Code или OpenClaw

СкиллШирокий доступ321

CLI и MCP для проверки скиллов: повторяемые тесты на YAML, сравнение отчетов, поиск регрессий и процесс skilled-improve

CLIРасширенный доступ72

Проверяет пакеты Agent Skills: структуру, ссылки, объем в токенах и качество инструкций с оценкой моделью-судьей

CLIРасширенный доступ267

Коротко о README

Для AgentSessions в скриптах есть проверки загрузки содержимого и выбора элемента. В другом приложении агенту нужно отдельно убедиться, что окно показывает нужное состояние. Пакетная съемка использует TSV-манифест.

Бейдж для README

Исходный SKILL.md

---
name: sc-skill
description: Capture deterministic macOS screenshots for testing, docs, release notes, and marketing assets. Use when asked to automate app screenshots, batch-generate screenshot sets, standardize window sizing/composition, or choose between Peekaboo and native macOS screenshot tooling.
---

# SC Skill

## Overview

Use this skill to produce repeatable screenshots for two modes:
- `testing`: stable evidence screenshots for QA/regression workflows.
- `marketing`: polished, consistently framed screenshots for docs/site/release assets.

This skill is macOS-first and uses `Peekaboo` as primary automation with native `screencapture` fallback.

## Quick Start

1. Normalize window size and position:
```bash
skills/sc-skill/scripts/sc_window_preset.sh --app "AgentSessions" --preset marketing
```

2. Capture one screenshot (auto-select tool):
```bash
skills/sc-skill/scripts/sc_capture.sh \
  --app "AgentSessions" \
  --mode marketing \
  --delay 0.25 \
  --max-edge auto \
  --window-preset auto \
  --output artifacts/screenshots/agent-sessions-main.png
```

3. Run a manifest batch:
```bash
skills/sc-skill/scripts/sc_capture_suite.sh \
  --manifest skills/sc-skill/references/examples/agent-sessions.tsv \
  --outdir artifacts/screenshots
```

Сообщить о проблеме