Agent skill

photo-clipper

Crop photos intelligently based on natural language prompts using GPT-5 vision analysis. Use when the user asks to crop or trim a photo, remove parts of an image, focus on a specific subject, improve composition, or remove distractions from edges.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ppx123-web/claude-config/tree/main/skills/photo-clipper

SKILL.md

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

python
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

bash
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

ppx123-web/claude-config

notebooklm

Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.

0 0
Explore
ppx123-web/claude-config

config-backup

Use when users want to save, backup, copy, export, or version control their Claude Code configuration files (commands, skills, agents) from ~/.claude/ to another directory. Triggered by phrases like "save my claude settings", "backup my claude config", "sync claude configuration", "copy ~/.claude to somewhere", "export my commands and skills", or "archive claude settings before making changes".

0 0
Explore
ppx123-web/claude-config

talk-dig

Analyze academic talk posters to discover and summarize the speaker's relevant papers. Extracts speaker info and topic from poster images, searches for their papers online, and provides comprehensive summaries.

0 0
Explore
ppx123-web/claude-config

config-restore

This skill should be used when users want to restore, reload, or copy their Claude Code configuration files (commands, skills, agents) from a backup directory back to ~/.claude/. Triggered by phrases like "restore my claude config", "reload claude settings", "copy config back to ~/.claude/", "restore from backup", "recover claude configuration", "import commands and skills from backup", "I accidentally deleted my commands", "restore my old skills", "copy config from backup", or "I need to recover my claude settings from a backup".

0 0
Explore
ppx123-web/claude-config

photo-color

Adjust photo brightness, contrast, and saturation based on natural language prompts using GPT-5 text analysis. Use when the user asks to adjust brightness, change contrast, modify saturation, apply a specific style, or fix photo issues like washed out colors.

0 0
Explore
ppx123-web/claude-config

todo

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results