Photo Clipper

When to Use

Use this skill when the user asks to:

• •Crop or trim a photo
• •Remove parts of an image (e.g., "remove 20% from top")
• •Focus on a specific subject or area
• •Improve composition (e.g., "apply rule of thirds")
• •Remove distractions from edges
• •Adjust framing or aspect ratio

Instructions

This skill uses GPT-5 vision API to analyze photos and suggest intelligent cropping. Always:

1. •Validate input - Ensure photo exists and is JPG/PNG format
2. •Call GPT-5 - Get clipping suggestions based on user's natural language prompt
3. •Validate safety - Ensure clipping doesn't remove more than 50% per dimension
4. •Apply clipping - Crop the photo and save to new file (never overwrite original)
5. •Report results - Show what was removed and GPT-5's reasoning

Usage

from photo_clipper import main

result = main(
    photo_path="photo.jpg",
    prompt="Remove 20% from top to reduce empty sky"
)
# Returns: "photo-clipped.jpg"

Command Line

python photo_clipper.py <photo_path> "<prompt>" [output_path]

Examples

Remove empty sky:

Remove 30% from top to reduce empty sky

Focus on subject:

Crop to focus on the person's face in the center

Remove distractions:

Remove the partial tree on the left edge

Improve composition:

Apply rule of thirds to balance the composition

Trim specific amount:

Remove 10% from all edges for a cleaner frame

Output

• •Returns path to clipped photo
• •Never overwrites original
• •Format: {original_name}-clipped.{ext}
• •Displays GPT-5's confidence score and reasoning

Error Handling

• •Falls back to safe defaults (no clipping) if GPT-5 unavailable
• •Validates parameters (max 50% removal per dimension)
• •Clear error messages for missing files or invalid formats

Requirements

• •OPENROUTER_API_KEY environment variable must be set
• •Photo must be JPG or PNG format
• •Photo under 50MB recommended

Technical Implementation

See references/implementation.md for:

• •GPT-5 vision API integration
• •Cropping algorithm details
• •Error handling strategy
• •Performance optimization

Examples

See examples/common-use-cases.md for:

• •Remove empty sky
• •Focus on subject
• •Remove distractions
• •Improve composition
• •Error handling scenarios