SkillFoxx

SC Skill

A skill helps an agent capture macOS windows for tests and documentation, choosing sizes, capture tools and output files

  • 945 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • Scripts control windows and close target application windows by default
  • Images can contain secrets, documents and open-session data
All reasons and checks

jazzyalex/agent-sessionsAuthor:jazzyalex

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/sc-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Scripts control windows and close target application windows by default
  • Images can contain secrets, documents and open-session data

This is third-party code. Review the repository files before installing.

What it does

SC Skill gives an agent a Mac application screenshot workflow. A script first sets the window size and position, then saves an image. The `testing` and `marketing` modes select composition and output-size settings. It chooses Peekaboo when installed and permitted, with native `screencapture` as a fallback. The caller can select a tool, output path and image size, and optionally write a separate metadata JSON file. Use `--app` to select the target application. Some readiness checks are specific to AgentSessions. Fixed window dimensions help repeat a composition for other apps without guaranteeing identical content.

Who it is for. macOS application testers asking an agent to prepare window screenshots for tests or documentation.

Good fit when

  • Capture several application states with a consistent window position
  • Save a documentation screenshot under a chosen file name
  • Choose between installed Peekaboo and native macOS capture
  • Save capture-mode and region metadata beside an image

Not a fit when

  • You need Windows or Linux application screenshots
  • You cannot activate, move or close user windows
  • You need an automatic guarantee that a UI has no visual defects

Example request

Read SC Skill and prepare a capture command for my app in `testing` mode. Show the command without capturing first. Keep windows open afterward and save the image to `artifacts/screenshots/settings.png`.

Limitations

Scripts target macOS with Bash and AppleScript; optional image processing may need Python and Pillow. Peekaboo needs Screen Recording and Accessibility, while window control depends on macOS permissions. Single capture activates the app, repositions its window and closes its windows after saving by default; save documents first. Images can contain secrets that stable filenames or repeatable window dimensions do not detect.

How to disable. Remove SC Skill from the agent’s skill directory and stop any running script. Revoke capture and Accessibility permissions if no longer needed. Delete saved images and metadata separately.

FAQ

What should I install?

Use the complete `skills/sc-skill` directory. It contains screenshot scripts; generic app capture does not require installing the Agent Sessions desktop application.

Can I inspect the command without capturing?

Add `--dry-run` to `sc_capture.sh`. It prints the selected command. This checks parameters, not whether macOS will permit a real capture.

How do I keep windows open?

Pass `--no-close-window` for a single capture. Otherwise the script attempts to close target application windows afterward. Do not use closing mode with unsaved documents.

How do the modes differ?

They use different image sizes and window presets. With `--max-edge auto`, `testing` caps the long edge at 1800 pixels and `marketing` at 2560. Check application visual errors separately.

Is Peekaboo required?

No. Choose `--tool native` for native capture. Auto mode selects Peekaboo if the program and required permissions are available, with native macOS capture as a fallback.

What license does SC Skill use?

MIT.

Discussion

No questions or reviews yet.

Skills

A skill that helps an agent inspect Scrawl screen recordings using keyframes, spoken explanations and the user’s drawn marks.

SkillExtended access913

Web page screenshots for agents: a local MCP server and CLI driving your own Chrome, with secrets masked before pixels are written

MCP serverExtended access93

Caliper runs agent tasks with and without your skill, then shows whether the skill helps and how many tokens it costs

CLIExtended access232
Official

Midscene skills drive a browser, desktop, Android, iOS and HarmonyOS from screenshots and build Vitest E2E tests through Claude Code or OpenClaw

SkillBroad access321

A CLI and MCP for testing agent skills: repeatable YAML evals, report comparison, regression detection and skilled-improve

CLIExtended access72

Validates Agent Skills packages: structure, links, token weight and instruction quality, with optional LLM-as-judge scoring

CLIExtended access267

README in short

The scripts include AgentSessions-specific content-loading and selection checks. For another app, the agent must separately confirm the intended window state. Batch capture uses a TSV manifest.

README badge

Original 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
```

Report a problem