icloud-photos

Organize iCloud Photos libraries by creating albums and detecting duplicates.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/pooriaarab/skills --skill icloud-photos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: icloud-photos
Source: https://github.com/pooriaarab/skills/tree/main/organizer/icloud-photos
Command: npx skills add https://github.com/pooriaarab/skills --skill icloud-photos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing and organizing large iCloud Photos libraries can be time-consuming and complex, especially when identifying duplicates, creating albums, and freeing storage space.

Core Features & Use Cases

  • Photo Organization: Create event/date-based albums and group photos by year, month, or event.
  • Duplicate Detection: Identify exact and perceptual near-duplicate photos for deletion or review.
  • Cleanup and Optimization: Remove unwanted photos from Recents stream, tag faces, and reclaim storage space.
  • Use Case: If a user wants to delete duplicate photos and organize images from a specific trip, this Skill will automate those tasks effectively.

Quick Start

Ask the AI to organize my iCloud Photos by detecting duplicates and creating albums based on events.

Frequently Asked Questions about icloud-photos

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

FAQPage Schema
How do I find and remove duplicate photos in my iCloud Photos library?

To find and remove duplicate photos in iCloud Photos, this Skill identifies exact and perceptual near-duplicates for deletion or review. It automates duplicate detection to safely eliminate redundant images and reclaim storage space on macOS or iOS.

Can I automatically organize iCloud Photos into albums by event or date?

Yes, you can automatically organize iCloud Photos into albums by event or date. This Skill creates event-based albums and groups images by year, month, or specific event to streamline photo library management and simplify navigation.

Does this photo cleanup method work on macOS and iOS with Photos.app?

Yes, this photo cleanup method works on macOS and iOS environments with Photos.app enabled. It uses AppleScript or the osxphotos command-line tool to inspect and manage your library, ensuring automated and safe photo maintenance across Apple devices.

What is the best way to reclaim iCloud storage space by deleting unwanted photos?

The best way to reclaim iCloud storage space is by removing unwanted photos from the Recents stream and deleting duplicates. This Skill automates the cleanup and optimization process, tagging faces and eliminating redundant images to free up storage efficiently.

Why does organizing a large iCloud Photos library take so much time?

Organizing a large iCloud Photos library takes time because identifying duplicates, creating albums, and freeing storage space are complex manual tasks. This Skill automates those processes, simplifying photo library management and reducing maintenance effort.