screen-recorder

Record macOS screen content and convert recordings to GIF, WebP, or MP4.

3|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/smykla-skalski/sai --skill screen-recorder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screen-recorder
Source: https://github.com/smykla-skalski/sai/tree/main/screen-recorder/skills/screen-recorder
Command: npx skills add https://github.com/smykla-skalski/sai --skill screen-recorder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyobjc-framework-Quartz, pyobjc-framework-ScreenCaptureKit, pyobjc-framework-AVFoundation, psutil, pillow, imagehash, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of capturing screen recordings on macOS, ensuring they meet specific quality and format requirements for various platforms.

Core Features & Use Cases

  • Versatile Recording: Capture specific windows, regions, or the entire screen.
  • Format Conversion: Automatically convert recordings to optimized formats like GIF, WebP, and MP4.
  • Verification: Ensure recordings are valid, of the correct duration, and contain actual content.
  • Use Case: Create high-quality GIFs for GitHub READMEs, record demos for Discord, or generate media for JetBrains marketplace listings.

Quick Start

Record the 'GoLand' application window for 5 seconds and save it as a GIF optimized for GitHub.

Frequently Asked Questions about screen-recorder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate screen recording on macOS and convert it to a GIF?

You can automate macOS screen recording to capture windows or regions and automatically convert the output to optimized GIF, WebP, or MP4 formats. This ensures specific quality and duration requirements are met for various platforms.

Can I record a specific application window instead of the full screen on macOS?

Yes, macOS screen recording can target specific application windows rather than the entire screen. This allows you to capture only the relevant interface area and automatically verify the recording contains the correct content.

What's the best way to create GitHub README GIFs from macOS screen captures?

The best way to create GitHub README GIFs is to capture the targeted screen region and apply a platform preset. The recording is then automatically converted and verified for correct duration and valid content before export.

Does screen recording with automatic verification check for empty captures?

Yes, automatic verification ensures screen recordings are valid, of the correct duration, and contain actual content. This prevents exporting empty or corrupted video files when generating media for platform listings.

Do I need specific macOS frameworks to capture and convert screen recordings?

Yes, capturing and converting screen recordings requires macOS frameworks like ScreenCaptureKit, Quartz, and AVFoundation. These dependencies handle the video capture, while Pillow and imagehash assist with format conversion and content verification.

Why does my automated screen recording fail verification before format conversion?

Automated screen recording verification fails when the capture is invalid, has an incorrect duration, or lacks actual content. The system validates these conditions before proceeding with GIF, WebP, or MP4 conversion to ensure output quality.