// 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.
| 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. |
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.
skills/sc-skill/scripts/sc_window_preset.sh --app "AgentSessions" --preset marketing
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
skills/sc-skill/scripts/sc_capture_suite.sh \
--manifest skills/sc-skill/references/examples/agent-sessions.tsv \
--outdir artifacts/screenshots
testing: prioritize determinism and speed.marketing: prioritize composition consistency.--tool auto (defaults to Peekaboo when available and permitted).--tool native when you need zero external dependency and simple window-region capture.sc_window_preset.sh first.artifacts/screenshots/.....json) is opt-in via --metadata; default runs keep artifacts cleaner.--max-edge auto): testing=1800, marketing=2560, optimized/compressed for sharing/upload.testing/marketing) to avoid distorted/compressed UI composition.--no-close-window to keep it open).--no-close-after-suite to keep them open).AgentSessions, transcript readiness retry includes a built-in selection nudge (key down + 0.5s pause) to force transcript loading before capture.--allow-blank-transcript only when blank transcript output is acceptable.screen-purpose-state.png).scripts/sc_window_preset.sh: deterministic window sizing/placement.scripts/sc_capture.sh: single-shot capture with Peekaboo/native fallback.scripts/sc_capture_suite.sh: manifest-driven batch capture.references/tool-matrix.md: tooling decision matrix and tradeoffs.references/workflow-checklist.md: repeatable QA/marketing checklist.Verify agent session format compatibility for Agent Sessions. Use when any agent CLI updates, when monitoring flags drift, or when bumping max verified versions (fixtures + docs + tests). Covers session schema, usage/limits tracking, storage backends, and discovery path contracts for all supported agents.
Use when shipping a release of Agent Sessions — bumping version, updating CHANGELOG, building, signing, notarizing, publishing appcast, and creating a GitHub release.
Create and ship AgentSessions support for a new or changed local AI agent/provider. Use when adding, reviewing, testing, documenting, or marketing a provider integration, session parser, transcript source, support-matrix entry, verified-version bump, or provider UI surface; drives the full loop from pre-support research through binary install, real session capture, fixture redaction, parser/discovery/search/UI integration, QA, review/fix loops, support records, PR/release notes, and conservative marketing claims.
Maintain Agent Sessions agent support matrix and JSON/JSONL parsing compatibility. Use when checking upstream agent releases for session format changes, updating max verified versions in docs/agent-support/agent-support-matrix.yml, or updating docs/agent-json-tracking.md and fixtures/tests.
