cleanshot

Automate screenshots, recordings, scrolling captures, and OCR via CleanShot X CLI.

9|3|Updated Jun 29, 2012
One-click install
npx skills add https://github.com/whilp/dotfiles --skill cleanshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanshot
Source: https://github.com/whilp/dotfiles/tree/main/.claude/skills/cleanshot
Command: npx skills add https://github.com/whilp/dotfiles --skill cleanshot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates taking screenshots, screen recordings, scrolling captures, and OCR text recognition using CleanShot X, replacing manual capture steps and speeding up visual data collection.

Core Features & Use Cases

  • Screen captures: area, fullscreen, or window captures with post-capture actions.
  • OCR & text extraction: convert captured images to searchable text.
  • Annotation & utility: annotate, pin, and manage captures for quick reference.

Quick Start

Use the cleanshot skill to perform a fullscreen screenshot of the active window.

Frequently Asked Questions about cleanshot

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

FAQPage Schema
How do I extract text from screenshots using OCR?

OCR text extraction converts captured images to searchable text automatically. The cleanshot Skill performs OCR recognition on screenshots, screen recordings, and scrolling captures, enabling you to extract and process text from visual content without manual transcription.

Can I automate fullscreen and area screenshots on desktop?

Yes, the cleanshot Skill automates fullscreen, window, area, and scrolling captures on desktop via CLI. You can specify coordinates, display parameters, and post-capture actions, with results saved to ~/Downloads/screens by default and automatic path reporting.

What's the difference between area captures and scrolling captures?

Area captures grab a defined rectangular region using coordinate and dimension parameters. Scrolling captures extend beyond the visible screen to capture full-page content, useful for documenting lengthy documents or web pages in a single image.

How do I annotate and manage screenshots after capture?

The cleanshot Skill supports annotation and pinning of captured images for quick reference. Post-capture actions let you organize, tag, and manage visual assets directly within your desktop workflow without switching tools.

Does cleanshot work with screen recordings and static captures?

Yes, the cleanshot Skill handles both screen recordings and static screenshots. You can choose capture type, apply OCR to extract text from recordings, and use annotation features across all capture modes.

What setup do I need to start capturing screenshots?

The cleanshot Skill requires CleanShot X CLI and a Bash environment. It uses coordinate, display, and action parameters via CLI subcommands, with an up to 10-second wait window for capture, and stores outputs in ~/Downloads/screens.