screenshot-annotator

Captures, annotates, and analyzes macOS screenshots using Peekaboo CLI and curl.

4|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/ianalloway/openclaw-skills --skill screenshot-annotator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot-annotator
Source: https://github.com/ianalloway/openclaw-skills/tree/main/screenshot-annotator
Command: npx skills add https://github.com/ianalloway/openclaw-skills --skill screenshot-annotator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo, curl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of capturing, annotating, and understanding visual information on your screen, making documentation and bug reporting significantly more efficient.

Core Features & Use Cases

  • Screenshot Capture: Capture full screen, specific windows, or custom regions.
  • Automatic Annotation: UI elements are automatically identified and labeled.
  • AI-Powered Descriptions: Generates descriptions of screen content and UI elements.
  • Use Case: Quickly document a software bug by capturing a screenshot, having the UI elements automatically annotated, and getting an AI-generated description of the issue for your bug report.

Quick Start

Capture and annotate the current screen, saving it to /tmp/annotated-screen.png.

Frequently Asked Questions about screenshot-annotator

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

FAQPage Schema
How do I automatically annotate UI elements in a macOS screenshot for bug reports?

You can automatically annotate UI elements in a macOS screenshot by using the Peekaboo CLI to capture your screen and generate AI-powered descriptions. This identifies and labels interface components automatically, streamlining documentation and bug reporting.

Can I capture a specific window or custom region and generate an AI description of it?

Yes, you can capture a full screen, a specific window, or a custom region. The Skill uses the Peekaboo CLI to capture the selected area and AI to generate descriptions of the screen content and UI elements.

Do I need Peekaboo and curl installed to capture and analyze screenshots on macOS?

Yes, you must have both Peekaboo and curl installed and accessible in your environment. These dependencies are required to capture, annotate, and generate AI-powered descriptions of screenshots on macOS.

What is the best way to create a tutorial by identifying and labeling screen elements?

The best way to create a tutorial is to capture your screen with Peekaboo, which automatically identifies and labels UI elements. The AI then generates descriptions of the interface, making it easy to document steps for tutorials.

Why does my screenshot annotation fail with a command not found error?

Screenshot annotation fails with a command not found error if the required dependencies, Peekaboo and curl, are not installed or are not accessible in your system's PATH environment on macOS.