Stats
Actions
Tags
Save clipboard images to numbered PNGs
How this skill is triggered — by the user, by Claude, or both
Slash command
/paste-image-to-file-tool:skills/paste-image-to-file-toolThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- When saving multiple screenshots to files quickly
This skill provides access to the paste-image-to-file-tool CLI tool that watches the clipboard for images and saves them as numbered PNG files (1.png, 2.png, ...) in the current directory.
Use this skill when:
Do NOT use this skill for:
git clone https://github.com/dnvriend/paste-image-to-file-tool.git
cd paste-image-to-file-tool
uv tool install .
# Auto mode (default) - polls clipboard, saves new images
paste-image-to-file-tool
# Manual mode - press Enter to save current clipboard
paste-image-to-file-tool -m
# With verbose logging
paste-image-to-file-tool -v
Watches clipboard for images and saves them with incremental filenames.
Usage:
paste-image-to-file-tool [OPTIONS]
Options:
| Option | Description |
|---|---|
-a, --auto | Auto mode: poll clipboard, save on change (default) |
-m, --manual | Manual mode: press Enter to save clipboard image |
-v, --verbose | Increase verbosity: -v=INFO, -vv=DEBUG, -vvv=TRACE |
--telemetry | Enable OpenTelemetry tracing |
--version | Show version and exit |
--help | Show help message |
Examples:
# Auto mode - polls clipboard every 0.5s
cd ~/screenshots
paste-image-to-file-tool
# Output:
# waiting for paste (auto mode, Ctrl+C to stop)
# writing 1.png
# waiting for paste
# writing 2.png
# Manual mode - press Enter to capture
paste-image-to-file-tool -m
# Output:
# waiting for paste (manual mode, press Enter to save, Ctrl+C to stop)
# <Enter>
# writing 1.png
# waiting for paste
# With verbose logging
paste-image-to-file-tool -vv
Behavior:
1.png exists, starts at 2.png)Generate shell completion scripts for bash, zsh, or fish.
Usage:
paste-image-to-file-tool completion generate SHELL
Examples:
# Generate for bash
eval "$(paste-image-to-file-tool completion generate bash)"
# Generate for zsh
eval "$(paste-image-to-file-tool completion generate zsh)"
# Generate for fish
paste-image-to-file-tool completion generate fish > \
~/.config/fish/completions/paste-image-to-file-tool.fish
Control logging detail with progressive verbosity levels. All logs output to stderr.
| Flag | Level | Output |
|---|---|---|
| (none) | WARNING | Errors and warnings only |
-v | INFO | + High-level operations |
-vv | DEBUG | + Detailed info, image hashes |
-vvv | TRACE | + Library internals |
Examples:
# INFO - see operations
paste-image-to-file-tool -v
# [INFO] Starting paste watcher in /Users/you/screenshots
# DEBUG - see detailed info
paste-image-to-file-tool -vv
# [INFO] Starting paste watcher in /Users/you/screenshots
# [DEBUG] Initial clipboard has image, hash: abc123
# [DEBUG] Saved image to /Users/you/screenshots/1.png
Enable tracing for observability.
# Via CLI flag
paste-image-to-file-tool --telemetry
# Via environment variable
export OTEL_ENABLED=true
paste-image-to-file-tool
Issue: Command not found
# Verify installation
paste-image-to-file-tool --version
# Reinstall if needed
cd paste-image-to-file-tool
uv tool install . --reinstall
Issue: No image in clipboard
-vv flag to see debug infoIssue: Files not saving
-vv to see detailed errorspaste-image-to-file-tool --help
0: Success (stopped with Ctrl+C)1: Error (permission denied, invalid options)-vv shows clipboard statenpx claudepluginhub dnvriend/paste-image-to-file-tool --plugin paste-image-to-file-toolFinds and displays recent screenshots from common directories on Windows, macOS, and Linux. Auto-detects locations, sorts images by modification time, and uses Read tool for visual display. Invoke via /screenshot [count].
Uploads screenshots, images, PDFs, and media to S3-compatible storage via MinIO Client, generates public/presigned URLs, supports batch uploads and history listing. Auto-triggers after Playwright screenshots.
Captures desktop screenshots (full screen, app/window, region) on macOS/Linux via Python/Bash scripts. Use for explicit requests or when tool-specific capture unavailable.