skill-paste-image-to-file-tool

# When to use

- When saving multiple screenshots to files quickly
- When capturing clipboard images with incremental naming
- When batch-saving images from clipboard

# paste-image-to-file-tool Skill

## Purpose

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.

## When to Use This Skill

**Use this skill when:**
- Saving screenshots or clipboard images to files
- Batch capturing images with auto-incrementing filenames
- Need to save multiple images quickly without naming each one

**Do NOT use this skill for:**
- Image editing or manipulation
- Converting image formats
- Working with existing image files

## CLI Tool: paste-image-to-file-tool

### Installation

```bash
git clone https://github.com/dnvriend/paste-image-to-file-tool.git
cd paste-image-to-file-tool
uv tool install .
```

### Prerequisites

- Python 3.14+
- [uv](https://github.com/astral-sh/uv) package manager
- macOS (uses clipboard access)

### Quick Start

```bash
# 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
```

## Progressive Disclosure

<details>
<summary><strong>📖 Core Commands (Click to expand)</strong></summary>

### Main Command - Save Clipboard Images

Watches clipboard for images and saves them with incremental filenames.

**Usage:**
```bash
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 messag