Can I use this with automated testing tools like Playwright?

Yes, the skill includes specific implementation patterns for Playwright and Python to ensure automated screenshots are saved directly into the organized folder structure.

How does this skill handle filenames with spaces on macOS?

It uses specialized shell glob patterns within loops to ensure files are moved and renamed correctly, avoiding common manual escaping errors associated with macOS default naming.

How do I reference specific screenshots in my prompt?

You can use chronological notation such as 'HEAD~1' for the most recent image, specific indices like 'N', or arrays like '[1, 3]' to reference multiple screenshots in order.

Where are the screenshots stored after processing?

By default, the skill moves all analyzed and renamed images to a centralized '~/Desktop/claude_screenshots/' directory for better organization.

Screenshot Manager & Orchestrator

Name: Screenshot Manager & Orchestrator
Author: WarrenZhu050413

byWarrenZhu050413

•

Browser Automation

Automates the organization, descriptive renaming, and retrieval of screenshots to provide structured visual context for Claude.

About

This skill establishes a professional workflow for managing visual assets within Claude Code, solving the common chaos of cluttered desktops and cryptic filenames. It provides standardized patterns for reading screenshots from the local system, renaming them with YYYY-MM-DD date prefixes and descriptive slugs, and organizing them into a dedicated directory. By utilizing advanced shell globbing techniques, it seamlessly handles macOS-specific filename challenges like spaces and special characters, ensuring Claude can always access and analyze the correct visual context without file path errors.

Key Features

Automated organization into a centralized ~/Desktop/claude_screenshots directory
Advanced shell globbing patterns to handle complex macOS filenames with spaces
Ready-to-use snippets for Playwright and Python automation integration
Chronological retrieval support using HEAD~n and index-based notation
Descriptive YYYY-MM-DD naming convention for improved chronological tracking
5 GitHub stars

Use Cases

Organizing and archiving UI bug screenshots during a frontend development session
Managing visual regression test results from automated browser scripts
Maintaining a searchable history of application states for documentation purposes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add warrenzhu050413/warren-claude-code-plugin-marketplace using-screenshots

For use in Claude.ai and ChatGPT

Download Skill

GitHub