Agent skill

Cleanup Screenshots

by ccplugins in ccplugins/awesome-claude-code-plugins

Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable).

Apache-2.0Auto-check passed

Install Cleanup Screenshots

skills CLI
$ npx skills add ccplugins/awesome-claude-code-plugins --skill cleanup-screenshots -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ccplugins/awesome-claude-code-plugins cleanup-screenshots --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/screenshot-janitor/skills/cleanup-screenshots .claude/skills/cleanup-screenshots && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cleanup-screenshots
GitHub stars
967
Token cost
~794 tokens
SKILL.md length
306 words
Files
1
Skills in repo
68
Repo updated
First seen
Licence
Apache-2.0

At a glance

Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable).

  • Works in 5 steps: Find candidates → Show a clear list → Ask for approval → …
  • Include clean up screenshots
  • SKILL.md covers Flow and Notes
  • Calls bash

What it does

Cleanup Screenshots is an agent skill from ccplugins/awesome-claude-code-plugins. Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable). Use before ending a session, when asked to tidy the Desktop/screenshots folder, or when the screenshot-janitor Stop hook suggests cleanup. Triggers include "clean up screenshots", "delete screenshots", "tidy my desktop", "remove the screenshots".

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code. The licence is Apache-2.0.

When your agent uses it

  • Include clean up screenshots
  • Delete screenshots
  • Tidy my desktop
  • Remove the screenshots

Example prompts

  • “clean up screenshots”
  • “delete screenshots”
  • “tidy my desktop”
  • “/cleanup-screenshots”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Find candidates
  2. Show a clear list
  3. Ask for approval
  4. Move to Trash
  5. Mark handled and report

What it can do on your machine

Read from SKILL.md and the folder at commit 5bd4f16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cleanup Screenshots loads about 794 tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~794

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ccplugins/awesome-claude-code-plugins at commit 5bd4f16, republished under its Apache-2.0 licence (© ccplugins). 306 words, ~794 tokens.

Download SKILL.mdSave it as .claude/skills/cleanup-screenshots/SKILL.md (or your agent's skills folder).
name
cleanup-screenshots
description
Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable). Use before ending a session, when asked to tidy the Desktop/screenshots folder, or when the screenshot-janitor Stop hook suggests cleanup. Triggers include "clean up screenshots", "delete screenshots", "tidy my desktop", "remove the screenshots".

Screenshot Janitor — Cleanup

Cleans up screenshots that piled up during this session safely: never rm; files are moved to the Trash and can be restored. Session scope comes from the started_at timestamp recorded by the SessionStart hook (only screenshots created during this session).

Helper scripts live next to this plugin. Resolve their location like this (works whether or not CLAUDE_PLUGIN_ROOT is set in skill context):

bash
SCRIPTS="$(cat "$HOME/.claude/screenshot-janitor/scripts-path" 2>/dev/null)"
[ -z "$SCRIPTS" ] && SCRIPTS="${CLAUDE_PLUGIN_ROOT}/scripts"

Flow

1. Find candidates
bash
bash "$SCRIPTS/find.sh"

Interpret the output:

  • NO_SESSION → no session record. Ask the user whether to scan all screenshots; if yes, run bash "$SCRIPTS/scan.sh" 0.
  • SESSION_META:<path> → remember this path; you will write the handled marker into its directory in step 5.
  • Following TSV lines are candidates: <mtime_epoch>\t<size_bytes>\t<path>.
  • If there are no TSV lines: say "No screenshots to clean up for this session 👍" and stop.
2. Show a clear list

Present the candidates as a numbered, human-readable table. Convert bytes to MB/KB and the mtime epoch to a readable time. Example:

Found 3 screenshots from this session:

  1.  Screenshot 2026-06-07 at 04.44.07.png   3.6 MB   04:44
  2.  Screenshot 2026-06-07 at 04.44.17.png   3.4 MB   04:44
  3.  Screenshot 2026-06-07 at 15.49.25.png   5 KB     15:49

Total ~7.0 MB.
3. Ask for approval

Offer clear options and wait for the answer:

  • All → move every candidate to the Trash.
  • Some → "tell me the numbers, e.g. 1,3" → only those.
  • Cancel → do nothing.

NEVER move files without approval.

4. Move to Trash

For the approved files (not permanent deletion!):

bash
bash "$SCRIPTS/trash.sh" "/full/path/Screenshot ....png" "/another/file.png"

trash.sh is cross-platform (macOS Trash / Linux gio trash / trash-cli). Always double-quote paths (they contain spaces). Never use rm.

5. Mark handled and report

After a successful cleanup, mark the session so it won't remind again (use the SESSION_META path from step 1):

bash
touch "$(dirname '<SESSION_META path>')/handled"

Then give a short summary: how many files, how much space freed, and that they went to the Trash ("you can restore from Trash if needed"). Mention any skipped files.

Notes

  • Configuration: create ~/.claude/screenshot-janitor/config.sh to override SCAN_DIRS, NAME_PATTERNS, or MIN_AGE_SECONDS (don't edit plugin files).
  • This skill also works standalone; it does not require the Stop hook.
  • Respond in the user's configured language.

© ccplugins, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/screenshot-janitor/skills/cleanup-screenshots of ccplugins/awesome-claude-code-plugins.

Open the folder on GitHubat commit 5bd4f16

Compare with similar skills

Cleanup Screenshots next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cleanup Screenshots compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cleanup Screenshots this skillccplugins/awesome-claude-code-plugins967—~794Automated safety check: PassApache-2.0
Screenshotnexu-io/open-design100k—~291Automated safety check: PassApache-2.0
Cleanupsimstudioai/sim30k—~1.4kAutomated safety check: PassApache-2.0
Tabler Screenshot Makertabler/tabler42k—~1.3kAutomated safety check: PassMIT
Screenshots Marketingnexu-io/open-design100k—~301Automated safety check: PassApache-2.0
PR Screenshotsgithub/awesome-copilot40k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Screenshot

    nexu-io/open-design

    Capture desktop, app windows, or pixel regions across OS platforms.

    100k GitHub stars~291 tokensUpdated today
    Testing & QAAuto-check passed
  • Cleanup

    simstudioai/sim

    Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit — analyzing in parallel, then applying fixes sequentially

    30k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Makes reproducible screenshots of Tabler components and screens for release notes, the website and social posts, using the repository's screenshots app.

    42k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Screenshots Marketing

    nexu-io/open-design

    Generate marketing screenshots with Playwright. An agent skill from nexu-io/open-design.

    100k GitHub stars~301 tokensUpdated today
    Frontend & DesignAuto-check passed
  • PR Screenshots

    github/awesome-copilot

    Official

    Embed before/after screenshots and annotated images in pull request descriptions.

    40k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • UI Screenshots

    github/awesome-copilot

    Official

    Capture screenshots of web apps during development using Playwright and PIL.

    40k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check passed

More from ccplugins/awesome-claude-code-plugins

All 68 skills in this repo
  • AI Meeting

    ccplugins/awesome-claude-code-plugins

    Run structured AI meetings for plans, product ideas, technical designs, business decisions, feature proposals, and strategy choices.

    967 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Fastapi App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new FastAPI backend with async SQLAlchemy 2.0, asyncpg, Alembic, Pydantic v2, and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Nextjs App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Next.js (App Router, TypeScript) web app with current packages and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dev Report

    ccplugins/awesome-claude-code-plugins

    Write up a coding session for a non-technical stakeholder — the context, what was built, and the engineering reasoning behind it — the way a senior engineer briefs a product manager who does not…

    967 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Difesa Attacchi

    ccplugins/awesome-claude-code-plugins

    Aggiunge a un sito/app un agente di difesa che rileva e blocca richieste malevole (SQL injection, XSS, path traversal, brute force, bot) con rate limiting, blocklist IP e modalità lockdown che…

    967 GitHub stars~781 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Cleanup Screenshots

What does Cleanup Screenshots do?

Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable). Cleanup Screenshots is an agent skill from ccplugins/awesome-claude-code-plugins. Find screenshots shared/accumulated during this Claude Code session and, with the user's approval, move them to the Trash (no permanent delete — recoverable).

When should I use Cleanup Screenshots?

Cleanup Screenshots fits situations like: include clean up screenshots; delete screenshots; tidy my desktop; remove the screenshots.

How do I install Cleanup Screenshots in Claude Code?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill cleanup-screenshots -a claude-code`. Or copy the skill folder (plugins/screenshot-janitor/skills/cleanup-screenshots in ccplugins/awesome-claude-code-plugins) into .claude/skills/cleanup-screenshots in your project. Claude Code loads it when a task matches its description.

How do I install Cleanup Screenshots in Codex?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill cleanup-screenshots -a codex`. Or copy the skill folder (plugins/screenshot-janitor/skills/cleanup-screenshots in ccplugins/awesome-claude-code-plugins) into .agents/skills/cleanup-screenshots in your project. Codex loads it when a task matches its description.

Can I use Cleanup Screenshots in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccplugins/awesome-claude-code-plugins --skill cleanup-screenshots -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cleanup-screenshots, .gemini/skills/cleanup-screenshots, .github/skills/cleanup-screenshots and .opencode/skills/cleanup-screenshots in your project.

What does Cleanup Screenshots need to run?

Going by SKILL.md and its folder, Cleanup Screenshots needs the command-line tools its instructions call (bash).

Does Cleanup Screenshots access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cleanup Screenshots safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cleanup Screenshots use?

Cleanup Screenshots is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cleanup Screenshots use?

About 794 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cleanup Screenshots?

Skills that share tags, products or a category with Cleanup Screenshots: Screenshot (nexu-io/open-design, 100k stars), Cleanup (simstudioai/sim, 30k stars), Tabler Screenshot Maker (tabler/tabler, 42k stars) and Screenshots Marketing (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cleanup Screenshots?

ccplugins (a GitHub organization) maintains it in ccplugins/awesome-claude-code-plugins, which has 967 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on August 12, 2026.

Source: ccplugins/awesome-claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.