Agent Skills › jazzyalex/agent-sessions › sc-skill

sc-skill

GitHub

用于 macOS 平台自动化生成确定性截图的工具，支持测试证据留存与营销资产制作。通过标准化窗口布局、自动选择捕获工具及批量处理功能，确保截图的一致性与可重复性。

skills/sc-skill/SKILL.md jazzyalex/agent-sessions

触发场景

需要为应用生成标准化截图用于文档或发布说明执行 QA 回归测试并需稳定截图作为证据批量生成一组应用界面截图

安装

npx skills add jazzyalex/agent-sessions --skill sc-skill -g -y

更多选项

不安装直接使用

npx skills use jazzyalex/agent-sessions@sc-skill

指定 Agent (Claude Code)

npx skills add jazzyalex/agent-sessions --skill sc-skill -a claude-code -g -y

安装 repo 全部 skill

npx skills add jazzyalex/agent-sessions --all -g -y

预览 repo 内 skill

npx skills add jazzyalex/agent-sessions --list

SKILL.md

Frontmatter

{
    "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

Normalize window size and position:

skills/sc-skill/scripts/sc_window_preset.sh --app "AgentSessions" --preset marketing

Capture one screenshot (auto-select tool):

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

Run a manifest batch:

skills/sc-skill/scripts/sc_capture_suite.sh \
  --manifest skills/sc-skill/references/examples/agent-sessions.tsv \
  --outdir artifacts/screenshots

Workflow

Choose mode:

testing: prioritize determinism and speed.
marketing: prioritize composition consistency.

Choose tool:

Start with --tool auto (defaults to Peekaboo when available and permitted).
Use --tool native when you need zero external dependency and simple window-region capture.

Enforce layout before capture:

Always run sc_window_preset.sh first.
Use consistent presets across runs to reduce visual drift.

Capture and archive:

Save to artifacts/screenshots/....
Sidecar metadata (.json) is opt-in via --metadata; default runs keep artifacts cleaner.
Default output uses mode-based max edge (--max-edge auto): testing=1800, marketing=2560, optimized/compressed for sharing/upload.
AgentSessions windows are normalized to a realistic working preset before capture (mode-based testing/marketing) to avoid distorted/compressed UI composition.
Single capture closes the target app window by default (--no-close-window to keep it open).
Suite runs close captured app windows after all requested screenshots by default (--no-close-after-suite to keep them open).
For AgentSessions, transcript readiness retry includes a built-in selection nudge (key down + 0.5s pause) to force transcript loading before capture.
Default transcript readiness remains fast-fail if loading still does not occur after nudge attempts.
If transcript readiness times out, capture fails fast by default; pass --allow-blank-transcript only when blank transcript output is acceptable.

Guardrails

Never run captures from XCTest-driven launches when validating user-visible UI behavior; use a normal app launch.
Keep screenshot naming stable and descriptive (screen-purpose-state.png).
Avoid manual resize/drag between shots; use presets.
For multi-shot runs, use the suite manifest instead of ad-hoc commands.