// 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.
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.
| 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.