randyhaylor/icloudpd-icloud-photo-backup
ai-tools/icloudpd-icloud-photo-backup/SKILL.md
icloudpd CLI for downloading/syncing iCloud Photos. Use when user asks about icloudpd, iCloud photo backup, or syncing iCloud photos locally.
tools
Updated Apr 20, 2026
$ install --global
skillsauthnpx skillsauth add randyhaylor/enhanceclaude icloudpd-icloud-photo-backupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 5:16 AM6.6s3 files scanned
SKILL.md
- name:
- icloudpd-icloud-photo-backup
- description:
- icloudpd CLI for downloading/syncing iCloud Photos. Use when user asks about icloudpd, iCloud photo backup, or syncing iCloud photos locally.
icloudpd — iCloud Photos Downloader
CLI tool to download/sync iCloud Photos to local storage. v1.32.2. Open source, Python-based.
- GitHub: https://github.com/icloud-photos-downloader/icloud_photos_downloader
- Docs: https://icloud-photos-downloader.github.io/icloud_photos_downloader/
- Reference: https://icloud-photos-downloader.github.io/icloud_photos_downloader/reference.html
Install
- pip:
pip install icloudpd(Windows: add--user) - Docker:
docker run -it --rm icloudpd/icloudpd:latest icloudpd --help - npm:
npx --yes icloudpd - Arch:
yay -S icloudpd-bin - Snap:
sudo snap install icloudpd - Binary: download from GitHub Releases
Modes
- Copy (default) — download only, iCloud untouched
- Sync — download + delete local files removed from iCloud (
--auto-delete) - Move — download + delete from iCloud (
--keep-icloud-recent-days N)
Docs: https://icloud-photos-downloader.github.io/icloud_photos_downloader/mode.html
Key Flags
| Flag | Purpose |
|---|---|
| --username X | Apple ID email; repeatable for multi-account |
| --directory X | Local download root |
| --watch-with-interval X | Continuous sync, interval in seconds |
| --keep-icloud-recent-days X | Move mode; delete from iCloud except last X days |
| --auto-delete | Sync mode; mirror iCloud deletions locally |
| --recent X | Process only X most recent assets |
| --until-found X | Stop after X consecutive already-downloaded assets |
| --album X | Specific album(s); repeatable |
| --list-albums | List available albums |
| --library X | Choose library (default: Personal Library) |
| --skip-videos | Skip video assets |
| --skip-photos | Skip photo assets |
| --skip-live-photos | Skip live photo assets |
| --set-exif-datetime | Write EXIF date if missing |
| --folder-structure X | Subfolder naming scheme |
| --dry-run | Preview changes, no downloads |
| --auth-only | Authenticate and exit |
| --size X | Asset size to download |
| --domain cn | Use .cn domain (mainland China) |
| --password-provider X | Password source: parameter, keyring, console |
| --mfa-provider X | MFA code source |
| --cookie-directory X | Custom auth token folder (default: ~/.pyicloud) |
Full list: icloudpd --help
Auth
- Supports 2FA via console prompt or web UI
- Store password in system keyring:
icloud --username X - Web UI for headless/NAS: https://icloud-photos-downloader.github.io/icloud_photos_downloader/webui.html
- Not compatible with Advanced Data Protection (ADP) — must disable ADP
- Hardware keys (FIDO) not supported
- Clear
~/.pyicloudto reset auth state - Docs: https://icloud-photos-downloader.github.io/icloud_photos_downloader/authentication.html
Common Recipes
# One-time download of everything
icloudpd --directory ~/icloud-photos --username [email protected]
# Continuous sync every hour
icloudpd --directory ~/icloud-photos --username [email protected] --watch-with-interval 3600
# Move mode: download all, keep only last 30 days in iCloud
icloudpd --directory ~/icloud-photos --username [email protected] --keep-icloud-recent-days 30
# Download specific album
icloudpd --directory ~/icloud-photos --username [email protected] --album "Vacation 2024"
# Docker with timezone
docker run -it --rm -v $(pwd)/Photos:/data -e TZ=America/New_York \
icloudpd/icloudpd:latest icloudpd --directory /data --username [email protected] --watch-with-interval 3600
# Dry run to preview
icloudpd --directory ~/icloud-photos --username [email protected] --dry-run
# Auth-only (pre-authenticate, useful for automation)
icloudpd --username [email protected] --auth-only
Gotchas
- First run may fail with
Bad Request (400)— Apple needs 5–10 min to prepare; retry --keep-icloud-recent-daysuses photo creation date, not upload date- Assets excluded by filters (e.g.
--skip-videos) are never deleted from iCloud - Too-short
--watch-with-intervalmay trigger Apple throttling - Windows Docker: use
%cd%or full path instead of$(pwd); Linux containers only
Related Skills
randyhaylor/ai-tools/xstate
tools
VerifiedTrustedCommunity
# XState v5 Quick Reference ## How to Look Up API Details For complete function signatures, types, and interfaces, **grep `api-reference.md`** — do NOT read it in full (12k+ lines). Example: ``` Grep pattern="createActor" path="~/.claude/skills/xstate/api-reference.md" output_mode="content" -C 5 ``` Then use `Read` with `offset`/`limit` to get the full section. This is the primary way to get precise technical info when the quick reference below isn't enough. ## Design Workflow Recommended
SKILL.mdUpdated Apr 20, 2026
randyhaylor/vscode-agent-teams
tools
VerifiedTrustedCommunity
Workaround for agent teams in VS Code extension where TeamCreate teammates cannot execute tools. Uses an echo-back-and-resume pattern where agents return tool requests instead of executing them directly.
SKILL.mdUpdated Apr 20, 2026
randyhaylor/typographic-hierarchy
development
VerifiedTrustedCommunity
Format documentation, READMEs, and structured text using header hierarchy where each level stands alone. Use when creating docs, research notes, summaries, or when user requests 'scannable,' 'well-structured,' 'skimmable,' or 'readable at multiple depths' output. Applies to markdown, technical specs, and any hierarchical text formatting.
SKILL.mdUpdated Apr 20, 2026
randyhaylor/test-driven-development
development
VerifiedTrustedCommunity
Enforce strict Test-Driven Development workflow: write one test, make it pass, verify, then proceed. Prevents over-implementation and ensures code matches requirements exactly. Use when implementing new features, adding settings, or building functionality incrementally.
SKILL.mdUpdated Apr 20, 2026