screenshot

Capture macOS monitors or windows and save timestamped screenshots to a project folder.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill screenshot-stefanmaksimek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/StefanMaksimek/dev-challenge-2026/tree/main/.claude/skills/screenshot
Command: npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill screenshot-stefanmaksimek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users often struggle with quickly capturing and organizing screenshots during workflows. This skill automates capturing screenshots for monitors or apps and saves them in a project folder, enabling rapid documentation and sharing.

Core Features & Use Cases

  • Monitor and window captures: Capture entire displays or specific application windows with minimal prompts.
  • Automated naming and organization: Saves images with timestamped filenames into a configurable directory.
  • Quick integration: Triggered via common prompts or hotkeys to fit into existing workflows.

Quick Start

To capture the main monitor: screencapture -D 1 -x "screenshots/$(date +%Y%m%d_%H%M%S)monitor1.png" To capture a specific window: WINDOW_ID=$(osascript -e 'tell application "System Events" to get id of first window of process "<APP_NAME>"') screencapture -l $WINDOW_ID -x "screenshots/$(date +%Y%m%d%H%M%S)_<APP_NAME>.png"

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I automate macOS screenshot capture and save files with timestamps?

You can automate macOS screenshot capture by executing native shell commands like screencapture with timestamp variables, saving images directly into a designated project folder for rapid visual documentation.

Can I capture a specific application window on macOS using a command line script?

Yes, you can capture a specific application window by using osascript to retrieve the target window ID, then passing that ID to the screencapture command to save the specific window image.

Does the macOS screencapture tool require any external installations to monitor capture?

No, automated monitor capture relies entirely on native macOS commands including screencapture and osascript, requiring absolutely no external installations or package dependencies to function.

What is the best way to capture an entire display on macOS for documentation?

The best way to capture an entire display is using the screencapture command with the display flag, automating monitor captures and organizing them with timestamped filenames for consistent project documentation.

Are there limitations when using osascript to get window IDs for screenshot automation?

Using osascript to get window IDs for screenshot automation requires exact application process names, and capturing specific windows depends on the target application exposing its window properties correctly.