parish-create-album
Add a photo album to the Fotogalerie of the new farakurim.cz site from a Zonerama album URL under eu.zonerama.com/FarnostKurim - download the album's zip (or take the one the user gives), pick up to 1
SKILL.md.claude/skills/parish-create-album/SKILL.md
GitHubCreate a gallery album
The site serves the album's photos from /uploads/fotogalerie/<id>/: pnpm add-album --write resizes the chosen
photos from the album's zip (four widths each) and stages them in uploads/, and the release uploads them. The
command downloads the zip itself, as the album's "Stáhnout" dialog does (without videos), and keeps it until --write
adds the album. Photos are never downloaded one by one: Zonerama answers a script with a "Bot Detected" image.
Finish with parish-publish-content.
1. Check the URL
The URL must be an album: https://eu.zonerama.com/FarnostKurim/Album/<albumId>. The profile or a tab
(…/FarnostKurim/425053) lists albums, not photos: ask for the album link.
If the user already gave the album's zip, pass it with --photos "<zip>" in the commands below; otherwise leave it
out.
2. Read the album
pnpm add-album "https://eu.zonerama.com/FarnostKurim/Album/<albumId>"
If the download fails ("could not download album …"), ask the user for the album's zip (they download it from the
album on Zonerama with "Stáhnout", usually to ~/Downloads/<YYYY_MM_DD> <title>.zip) and run it again with
--photos "<zip>". A large album takes a while to prepare and download (about 500 MB for 140 photos).
It prints JSON with the proposed id (ASCII kebab-case from the title with the year, usually at the end: medovy-den-2026,
so next year's album never takes over this one's links and photo folder; the site refuses an id without it), the title (sentence case, without
Zonerama's YYYY_MM_DD prefix), the date from that prefix, and the photo counts. It picks up to 15 photos of the
zip's most common landscape aspect ratio, in file-name order, because the strips crop every photo to 4:3: one shape
keeps the crops consistent, and portraits would lose most of the picture. total / inRatio / photos say how many
photos the zip has, how many fit and how many it takes.
The title and the date come from the album page. When Zonerama does not answer, the command says so and takes them
from the zip's name, which has no diacritics: fix the title with the user. If there is no date prefix, date is
empty: ask the user for the date of the event.
3. Confirm with the user
Show the title (fix the wording if Zonerama's is a working name, e.g. lower-case or abbreviated), the date, the id and "N of M photos (ratio 1.5)". Ask before continuing if fewer than 6 photos fit: the user may prefer another album.
Wait for the user's yes or corrections to these before adding anything.
4. Add the record and stage the photos
pnpm add-album "<album URL>" --write --title "<title>" --date <YYYY-MM-DD> --id <id>
Pass the confirmed values (each only when it differs from the JSON), and --photos "<zip>" if step 2 used it. It
reuses the zip step 2 downloaded and removes it once the album is added. It stages the photos in
uploads/fotogalerie/<id>/, adds the album, removes the oldest albums beyond the site's limit (they stay on Zonerama,
their files on the server) and prints each one it removed, then runs the gallery test. It refuses an id or album
already on the site, an id without the album's year (--id must keep it, e.g. vranov-2026), an album older than
all the kept ones, and an id whose folder is already on the server (the server's files are never overwritten): pass
another --id.
5. Publish
Follow parish-publish-content: the release uploads the staged photos.
Common mistakes
- Using the profile or tab URL instead of the album URL (the script refuses it).
- Writing the record or its photo paths by hand instead of
--write. - Downloading the photos one by one from Zonerama, or resizing them by hand: the zip and
--writedo it.