Create a year-labeled photo collage from a folder of annual photos. Designed for China visa applications requiring facial-change documentation (历年生活照片), but works for any year-based photo timeline.
Creates a chronological photo collage grid with year labels from a folder of photos named by year. Handles HEIC, JPEG, and PNG formats automatically, including HEIC conversion on macOS.
If the user hasn't specified a folder, use the current working directory. List the files to confirm they contain year-named photos (filenames starting with a 4-digit year).
If the user wants to rotate specific year photos before generating the collage:
# Rotate clockwise 90° using macOS sips (handles HEIC, JPEG, PNG)
sips -r 90 "<filename>"
# Rotate counter-clockwise 90°
sips -r -90 "<filename>"
# Rotate 180°
sips -r 180 "<filename>"
Apply to all files matching the requested years, then confirm before proceeding to collage generation.
Use the bundled script:
python3 "$SKILL_DIR/scripts/create_collage.py" "<photo_folder>" [output_filename]
<photo_folder>: Path to folder containing year-named photosoutput_filename (optional): defaults to photo_collage_年度照片.jpgThe script will:
sipsopen "<photo_folder>/photo_collage_年度照片.jpg"
Show the user the output path and confirm success.
Basic collage generation:
/photo-year-collage
→ Uses current directory, generates collage
With rotation:
User: rotate 2014, 2020 clockwise then make collage
→ Rotate those years, then generate collage
Specific folder:
/photo-year-collage ~/Documents/visa-photos
→ Uses specified folder
sips (built-in) for HEIC conversion and rotationpip install Pillow --break-system-packages
A single high-quality JPEG (photo_collage_年度照片.jpg) placed in the photo folder, showing all photos in a 5-column grid, each labeled with its year in a dark banner.
photo-year-collage/
├── SKILL.md (this file)
└── scripts/
└── create_collage.py