Skip to content
cccskills
FreePublished on GitHub

recording

Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures. Probe capabilities before recording.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Recording and screenshots

  1. Pick the computer (computer_list, or pass computer — it switches).
  2. Check request_access when readiness is unknown. On a supported target, use recording_start with optional display, region, fps and durationSec (macOS auto-stop), or intervalMs (HarmonyOS snapshot cadence).
  3. Do the work (or let the user do it).
  4. recording_stop with the returned id → finalized file path + bytes.
  5. recording_list shows everything saved; recording_status checks one.

Platform truths:

  • macOS: ScreenCaptureKit inside the signed helper captures a display or region straight to .mov — no system recorder selection UI and no desktop dimming overlay. If capture is denied, Screen Recording permission is missing for whoever ran it: the Codewhale Computer Use app when request_access says via: "app", else the terminal that hosts the server — tell the user which, do not retry.
  • Windows and Linux: recording is unavailable pending session-owned recorder cleanup. Use screenshots; installing ffmpeg does not enable it.
  • HarmonyOS: no native CLI recorder; the backend captures snapshot_display frames at intervalMs and muxes with ffmpeg on stop. The receipt labels the mode snapshot-series — never call it real-time.

Screenshots: screenshot returns a saved path, geometry and raster_id. Carry that ID in pixel targets and as the parent of zoom when a target is too small to read. Each zoom returns a new child ID; use it for child-image coordinates. OCR coordinate targets already include their pin. Pins remain reusable while current; older unpinned calls retain latest-raster behavior. A replaced capture, app launch or route change retires the context. On raster_stale or no_raster, observe again; never drop the ID to retry. Pins detect capture replacement, not a changed UI: re-observe after UI changes and verify input separately. An omitted image cannot supply coordinates.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Operate desktop apps and isolated browsers on registered computers. Use for tasks that require an app interface, accessibility, screenshots or recording. Use Chromewhale for the user's signed-in Chrome.

The English summary is being prepared. Showing the original description.

codewhale-hq/codewhale-cu-plugin3Updated Oct 16, 2026

See all skills by codewhale-hq

Report a problem with this skill