Imported from lebobo88/RLM-Creative (.claude/skills/shot-list-protocol/SKILL.md). Install upstream with npx skills add lebobo88/RLM-Creative --skill shot-list-protocol. Copyright stays with the author.

Shot List Protocol

Helios's working document for translating a CreativeBrief into a renderable ShotList. Every visual asset traces back to a shot entry.

Purpose

Produce a ShotList envelope that satisfies the Hydra schema, follows channel-appropriate pacing, and gives downstream generation tools (comfyui, video-synth, gemini-image) unambiguous direction.

When to use

• /photo-direction is invoked.
• /creative-campaign reaches the visual-direction phase and Helios needs to fan out renders.
• An asset fails QC and a re-shot/re-render needs a refreshed entry.

Envelope schema (Hydra hydra_core/schemas.py:Shot)

Each shot:

• shot_id — sh-{seq:03} within a list (e.g. sh-001, sh-002)
• description — one sentence, action-first, subject-second
• camera_angle — one of wide, closeup, medium, aerial, pov
• focal_length_mm — integer; see lens grammar below
• duration_sec — float; only for motion shots, omit for stills
• lighting_notes — concise: key, fill, rim, practicals, time-of-day, mood ref

The enclosing ShotList envelope adds: type: "ShotList", campaign_id, shots: [Shot], target_channel, aspect_ratio, total_runtime_sec.

Inputs

• Active CreativeBrief (objective, key_messages, channels, brand_constraints)
• Optional mood references from eights.memory.recall(tags=["shot-library"])

Outputs

• ShotList JSON written via rlm.output.write to RLM/output/photo/{campaign_id}-shotlist-{date}.json
• One or more AssetJob envelopes derived from the list, dispatched to comfyui / video-synth / gemini-image

Camera angle grammar

• wide — establishes geography; subject occupies < 25% of frame; use to orient
• medium — subject from waist or hip up; conversational; default for product-in-context
• closeup — subject from shoulders up, or product macro; emotional or detail beat
• aerial — top-down or high-angle drone perspective; scale, scope, pattern
• pov — first-person; immersive, used sparingly; pairs with hand-held motion

Lens / focal-length grammar (full-frame equivalent)

Anamorphic: prefix with anamorphic- and the squeezed FF-equivalent (e.g. anamorphic-40).

Pacing rules per channel

Total runtime caps and cut cadence:

Hook rule: the first shot MUST land the core key_message visually within the first 3 seconds for short-form social, first 2 seconds for TikTok.

Rule of thumb: shots/min = 60 / average_cut_seconds. Hand-edit if narrative beats demand longer holds.

Procedure

1. Read the CreativeBrief. Identify which key_messages map to visual beats vs copy beats.
2. Pull mood + reference shots from eights.memory.recall(tags=["shot-library"], k=12).
3. Draft 6-12 shots (longer for broadcast; 4-8 for short-form social).
4. For each shot: pick angle, focal length, duration, lighting; populate lighting_notes using color-science mood entries.
5. Validate: shot_id sequence is contiguous; total duration_sec <= channel cap; first 3 seconds carry the hook.
6. Emit ShotList envelope; derive an AssetJob per shot tagged with the destination workflow recipe (see comfyui-workflow-recipes).
7. Hand off to Helios sub-crew for render; await brand-safety and color-science checks before sign-off.

Validation checklist

• Every shot has all six required fields populated
• camera_angle is from the controlled vocabulary
• focal_length_mm is a positive integer
• duration_sec is omitted for stills; present for motion
• Sum of duration_sec <= channel max runtime
• First-3s hook is identified and labeled
• aspect_ratio matches target_channel
• No two adjacent shots share identical camera_angle AND focal_length_mm unless intentional (a held beat)

Failure modes / escalation

• Total runtime exceeds channel cap — trim, or split into multi-cut campaign; do NOT emit over-cap.
• A shot requires a real person's likeness — route through brand-safety IP-clearance before render.
• Workflow recipe unavailable for an asset kind — escalate to Helios; consider adding a new recipe (procedural resource, low-risk class).

References

• Schema: hydra_core/schemas.py in the Hydra repository (Shot, ShotList)
• Mood + grade: color-science
• Render: comfyui-workflow-recipes