photo-book-builder

photo-book-builder is a skill for Claude Code, Codex from J-StaR-Films-Studios/VibeCode-Protocol-Suite. It costs 163 tokens per session (2,048 once invoked), scanned A, original, ISC.

A skill for turning a collection of photos into a high-resolution photo book prepared for printing. It can sort photos by date, balance their orientation, create full-page layouts, correct crops, and improve cover images.

In plain words
What is it for?
Use it to organise photo books, generate print-ready full-bleed layouts, fix existing page crops, map photos to layout cells, and upscale cover art.
Why use it?
It reduces the manual work of arranging many photos and finding layout or cropping problems before printing.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to organise photo books, generate print-ready full-bleed layouts, fix existing page crops, map photos to layout cells, and upscale cover art.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add J-StaR-Films-Studios/VibeCode-Protocol-Suite --skill photo-book-builder
Clone the repo
git clone --depth 1 https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for photo-book-builder

README.md
[![agentmods](https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder/github.svg)](https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder)
Your own site
<a href="https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder"><img src="https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for photo-book-builder

Your own site · 80×15
<a href="https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder"><img src="https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/photo-book-builder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 163 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,048 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00163 $0.02048
Opus 5 $0.00081 $0.01024
Sonnet 5 $0.00033 $0.00410
Haiku 4.5 $0.00016 $0.00205

Measured 11d ago against content hash 5a6c9b409055, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

photo-book-builder scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (scripts/create_full_bleed_layouts.py, scripts/organize_photos.py, scripts/revert_organization.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

assets/.agent/skills/ai-media/photo-book-builder/SKILL.md · 141 lines

How it starts

The opening of the file, as written. The whole thing — 141 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Photo Book Builder

This skill provides a complete system for organizing, structuring, and generating print-ready, high-resolution photo books. It is designed for 12" × 30" open spreads (15" × 12" closed book size) at 300 DPI, enforcing strict gutter margins to prevent content from being lost in the binding.

Core Capabilities

The photo book builder supports five main stages:

graph TD
    A[Stage 1: Prep & Organize] -->|organize_photos.py| B[Page Folders & Mapping JSON]
    B --> C[Stage 2 & 3: Layout Generation]
    C -->|create_full_bleed_layouts.py| D[9000x3600 px Print Spreads]
    E[Stage 4: Cover Upscaling] -->|upscale_covers.py| F[Print-Ready Cover JPEGs]
    D --> G[Stage 5: Correction Pass]
    G -->|custom renderer or patched generator| H[New Corrected Export Folder]

Stage-by-Stage Workflow

Stage 1: Preparation & Balanced Page Sorting

Chronological sequence must be preserved at a macro level, but photos should be scrambled within local windows (chunks) to balance the number of landscape ("L") and portrait ("P") images per page folder.

  • Target Pages: 20 page folders (page 1 to page 20).
  • Balanced Distribution: Target 11 or 12 photos per page (e.g. 9 Landscapes and 2-3 Portraits per page).
  • JSON Map: A mapping file photo_organization_map.json is generated to track which photos belong to which page.

Execution: Run the organizer script, specifying the source folder containing the flat list of JPEG images and the target output directory:

python scripts/organize_photos.py --dir "path/to/photos" --out "path/to/workspace" --seed 42

Note: If running on Windows, use python -Xutf8 to avoid console encoding issues with status output.


Stage 2: Grid Layout & Coordinates

Spreads are generated at $9000 \times 3600$ px (300 DPI). Each page half gets an active grid area of $4275 \times 3300$ px after subtracting margins and gutter seams:

  • Outer Margins: 150 px top, bottom, and outside edges.
  • Vertical Center Gutter: 150 px total gutter seam (no image content between $x = 4425$ and $x = 4575$).
  • Image Gaps: 40 px spacing horizontally and vertically.

Read the full file on GitHub · 141 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 141 lines · 163 tokens per session scan A 5a6c9b409055

Subscribe to this mod's changes

photo-book-builder is a skill published in the GitHub repository J-StaR-Films-Studios/VibeCode-Protocol-Suite (24 stars, last pushed today), licensed ISC. It adds 163 tokens to every session and 2,048 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gpt-image-2-style-library

Choose GPT-Image2 / gpt-image-2 visual styles and industrial prompt templates from the awesome-gpt-image-2 style library. Use when an agent needs to create, rewrite, classify, or improve image-generation prompts with repository-backed templates, categories, style tags, scene tags, pitfalls, and example cases.

freestylefly/awesome-gpt-image-2 · 72 tokens

seedance-prompt

This skill should be used when the user asks to write, improve, translate, compress, or debug a Seedance 2.0 video prompt; mentions T2V, I2V, V2V, R2V, camera direction, prompt quality, or provides reference assets for a production-ready prompt.

Emily2040/seedance-2.0 · 68 tokens

short-drama-storyboard

A workflow for turning a Chinese short-drama script and its visual facts into a shot-by-shot storyboard with frozen starting-frame prompts.

zenstory-ai/drama-skills · 102 tokens

short-drama-video-prompts

A writing guide for turning approved short-drama storyboards and starting images into copy-ready prompts for generating video scenes. It covers both image-to-video prompts, which use a reference image, and text-to-video prompts, which describe the scene in words.

zenstory-ai/drama-skills · 106 tokens

short-drama-develop

A Chinese-language writing workflow for turning novel, short-drama, or comic-drama ideas and source material into an adaptation plan, story direction, creative brief, story engine, and episode map.

zenstory-ai/drama-skills · 195 tokens

short-drama-write

A writing workflow for creating or revising a shootable Chinese short-drama or animated-drama episode in Markdown.

zenstory-ai/drama-skills · 108 tokens