organize-screenshots

Classifies scanned screenshots and renames them descriptively for archival.

2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/mostafa-drz/claude-skills --skill organize-screenshots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organize-screenshots
Source: https://github.com/mostafa-drz/claude-skills/tree/main/code/organize-screenshots
Command: npx skills add https://github.com/mostafa-drz/claude-skills --skill organize-screenshots

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill scans a folder for recent screenshots, visually classifies which ones are relevant to current work, and organizes them into a target directory with descriptive filenames to streamline asset curation for PRs, bug reports, or documentation.

Core Features & Use Cases

  • Automated discovery: Detects recent screenshots from a source folder (default ~/Desktop) and respects a configurable lookback window.
  • Contextual classification: Visually assesses relevance to the current project and highlights related assets.
  • Descriptive naming: Suggests and applies descriptive, context-first filenames for easy identification.
  • Flexible organization: Copies or moves assets to a target directory, preserving originals unless the user opts-in to move.
  • Preferences persistence: Stores user preferences for default source, lookback days, and naming style.

Quick Start

Run the organize-screenshots command to scan your Desktop for the last 3 days, classify assets, and organize them into the specified target folder.

Frequently Asked Questions about organize-screenshots

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

FAQPage Schema
How do I organize desktop screenshots for bug reports and PR documentation?

You can organize desktop screenshots by running a scan on your source folder with a configurable lookback window, which then classifies relevant images and renames them with descriptive filenames for easy use in PRs and bug reports.

Can I specify a custom source folder and lookback period for finding screenshots?

Yes, you can specify a custom source folder and lookback period using the optional --source and --days parameters, allowing you to narrow down screenshot discovery to specific directories and timeframes.

Does organizing screenshots with this tool delete the original files from my desktop?

Organizing screenshots does not delete original files by default; the tool copies assets to the target directory, preserving your originals unless you explicitly opt-in to move them.

How does automated screenshot classification work for dev workflows?

Automated screenshot classification works by visually assessing recently discovered screenshots against your current project context, highlighting related visual assets so you can quickly identify which images are relevant for documentation.

What is the best way to manage recurring screenshot naming preferences?

The best way to manage recurring naming preferences is through the built-in preferences file, which persists your default source directory, lookback days, and naming style settings across future screenshot organization runs.

Are there limitations when scanning for screenshots outside the default desktop directory?

There are no inherent limitations when scanning outside the default desktop directory, as the Skill accepts a custom --source parameter to target any specified folder path for screenshot discovery and organization.