| name | image-rotator |
| description | This skill should be used when users need to rotate images by 90 degrees. It handles image rotation tasks for common formats (PNG, JPG, JPEG, GIF, BMP, TIFF) using a reliable Python script that preserves image quality and supports both clockwise and counter-clockwise rotation. |
Image Rotator
Overview
Rotate images by 90-degree increments while preserving quality. This skill provides a deterministic Python script for image rotation tasks, eliminating the need to rewrite image manipulation code.
When to Use
Use this skill when users request:
- Rotating images by 90, 180, or 270 degrees
- Fixing image orientation
- Adjusting image alignment for documents or presentations
- Batch rotation operations
Quick Start
The skill includes scripts/rotate_image.py, a command-line utility for rotating images. The script uses PIL/Pillow for reliable image processing.
Basic Usage
Rotate an image clockwise by 90 degrees:
uv run python skills/image-rotator/scripts/rotate_image.py input.jpg
This creates input_rotated.jpg in the same directory.
Common Options
Specify output path:
uv run python skills/image-rotator/scripts/rotate_image.py input.jpg --output rotated.jpg
Rotate counter-clockwise:
uv run python skills/image-rotator/scripts/rotate_image.py input.jpg --direction counter-clockwise
Rotate 180 degrees (2x 90-degree rotations):
uv run python skills/image-rotator/scripts/rotate_image.py input.jpg --times 2
Rotate 270 degrees clockwise (or 90 counter-clockwise):
uv run python skills/image-rotator/scripts/rotate_image.py input.jpg --times 3
Supported Formats
- PNG
- JPG/JPEG
- GIF
- BMP
- TIFF
Implementation Notes
Prerequisites
The script requires Pillow (PIL fork):
uv add Pillow
Script Details
The rotation script (scripts/rotate_image.py):
- Uses PIL's
rotate() method with expand=True to prevent cropping
- Preserves image metadata when possible
- Returns clear success/error messages
- Handles edge cases (missing files, unsupported formats)
Workflow
When users request image rotation:
- Verify the input image path exists
- Determine rotation direction and amount (default: 90 degrees clockwise)
- Execute
scripts/rotate_image.py with appropriate parameters
- Report the output file location to the user
For batch operations, iterate through multiple images using the same script in a loop or shell command.
Resources
scripts/
rotate_image.py - Main image rotation utility with CLI interface
