photo-clipper

Crop JPEG/PNG photos from natural language prompts using GPT-5 vision analysis.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/ppx123-web/claude-config --skill photo-clipper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: photo-clipper
Source: https://github.com/ppx123-web/claude-config/tree/main/skills/photo-clipper
Command: npx skills add https://github.com/ppx123-web/claude-config --skill photo-clipper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the time-consuming task of cropping photos according to natural language prompts, leveraging GPT-5 vision analysis to produce well-composed results without manual editing.

Core Features & Use Cases

  • Intelligent cropping: Crop based on user prompts, preserving subject focus and composition.
  • Safety checks: Enforce maximum 50% removal per dimension to avoid over-cropping.
  • Non-destructive output: Always save to a new file with a "-clipped" suffix and provide reasoning.

Quick Start

Provide a photo and a natural language crop prompt to clip accordingly.

Frequently Asked Questions about photo-clipper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I crop a photo using a natural language prompt?

You can crop a photo by providing the image and a natural language prompt describing the desired framing. The tool applies GPT-5 vision analysis to identify subject emphasis and generate balanced crops.

Does intelligent cropping work with JPEG and PNG image files?

Yes, intelligent cropping supports both JPEG and PNG input files. The system includes input validation to ensure compatibility and processes the provided photo to generate the requested crop.

What's the best way to remove distracting edges without ruining the composition?

Using AI-assisted vision analysis identifies framing improvements and edge removals while preserving subject focus. It enforces a safe limit of 50% removal per dimension to prevent over-cropping and maintain composition.

How to crop photos non-destructively and keep the original file safe?

To crop photos non-destructively, the system always saves the result to a new file with a "-clipped" suffix. This ensures your original image remains untouched while the tool provides the reasoning for the crop.

Are there limitations to how much of an image can be cropped?

Yes, the main limitation for image cropping is a strict safety check that enforces a maximum removal of 50% per dimension. This prevents excessive cropping and ensures the output remains a balanced photo.

Why does my photo clip fail to process?

Your photo clip may fail due to unsupported file formats; only JPEG and PNG inputs are accepted. The system provides clear error handling to indicate validation issues or if the requested crop exceeds safe limits.