Breaks a documentary sequence into a detailed scene-by-scene breakdown with action descriptions, narration cues, interview placement, and B-roll requirements. Useful for paper edits, offline edit planning, and narration script development.
How this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:scene-breakdown-writerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Breaks a documentary sequence into a detailed scene-by-scene breakdown with action descriptions, narration cues, interview placement, and B-roll requirements.
Breaks a documentary sequence into a detailed scene-by-scene breakdown with action descriptions, narration cues, interview placement, and B-roll requirements.
Required: A description of the sequence (what it covers, what it needs to achieve narratively); the raw material available (interview excerpts, observational footage descriptions, archival material); the sequence's position in the film (opening, mid-film, climax, closing) Optional: Approximate target running time for the sequence; the film's overall tone and narration style; specific interview lines or quotes you want to include; the preceding and following sequences for context
Scene-by-scene breakdown document. Each scene: Scene number, Approximate running time, Action (what we see), Narration Cue, Interview Placement, B-roll Required. Followed by a Sequence Notes section flagging potential structural problems or missing material. Target length scales with sequence complexity — typically 400–700 words for a 4–6 minute sequence. Output ends with a "Next Step" note: which scene to verify material availability for first, whether to run commentary-writer to develop narration cues, and whether rough-cut-notes will be useful once an assembly cut exists.
Sequence: The opening sequence of a documentary about a fishing community's response to a dramatic decline in their catch over three years Narrative function: Establish the community, the landscape, the way of life — and introduce the crisis without explaining it yet Position: Film opening, before the title card Target running time: 5–6 minutes Available material: Observational footage of early-morning boat departure; harbor at dawn; boats returning with small catch; interview with veteran fisherman Elias Strand about what the sea used to be like; archive footage of the same harbor in the 1990s when the catch was abundant; underwater footage of fish schooling (2010, not current); community meeting footage (not for this sequence) Tone: Contemplative, visually led
Scene Breakdown — Opening Sequence Documentary: Fishing Community / Declining Catch Target: 5–6 minutes | Position: Pre-title
Scene 1 — Darkness before dawn Approx. running time: 0:45 Action: Black screen. The sound of water before the image. Slow fade up to: an exterior shot of the harbor in near-total darkness. A single light on one of the boats. The sounds of preparation — ropes, engines idling. Narration Cue: No narration. Sound only. Interview Placement: None. B-roll Required: Confirm pre-dawn harbor footage exists and is usable in low light. If not, this scene may need to be replaced with a cut from darkness to dawn.
Scene 2 — The departure Approx. running time: 1:15 Action: A fishing boat leaves the harbor. We follow it from the dock, then cut to on-board — the crew moving efficiently, doing a job they have done thousands of times. The harbor recedes. The open sea appears. Narration Cue: No narration. Possibly a single title card over black before this scene: the town name and "Atlantic coast." Interview Placement: None. B-roll Required: On-board footage of crew during departure. Aerial or wide shot of boat leaving harbor if available — do not use drone footage if it disrupts the observational register.
Scene 3 — The sea as it was Approx. running time: 1:00 Action: Archive footage: the harbor in the 1990s. Full boats. The same landscape, louder with life. Then: underwater footage from 2010 — a dense school of fish. Both sequences play without explanation. Narration Cue: No narration. Let the contrast work visually. Interview Placement: None. B-roll Required: Archive footage as described. Confirm archive rights are cleared. Underwater footage: confirm year and species visible are relevant to the current story.
Scene 4 — The return Approx. running time: 1:15 Action: The present-day boats returning to harbor. The catch is visible — or noticeably absent. We see the crew's faces as they dock. No one is laughing. The contrast with the archival abundance is felt, not stated. Narration Cue: Single narration line over the dock unloading — approximately: "This year, they brought back less than a quarter of what the boats could carry." (To be finalized in narration draft — this is the first time a fact is stated.) Interview Placement: None in this scene. B-roll Required: Close-ups of the catch (or near-empty hold). Faces of the crew. Avoid melodrama — observe rather than editorialize.
Scene 5 — Elias speaks for the first time Approx. running time: 1:15 Action: Elias Strand, veteran fisherman, at the harbor or on his boat. This is the first interview element in the film. He speaks, but not yet about what's wrong. Narration Cue: Narration sets Elias up briefly before he speaks: approximately one sentence on who he is. Then out. Interview Placement: Elias on what the sea used to feel like — his relationship to it, how long his family has fished. Not yet the decline. Save his account of the decline for later in the film. Use the lines where he speaks about the sea with love and memory. B-roll Required: Observational footage of Elias at work, in context. His hands. The harbor behind him.
Scene 6 — The title card Approx. running time: 0:15 Action: Elias's final words fade out over a wide shot of the harbor. Title card appears. Narration Cue: None. Interview Placement: None. B-roll Required: A single compelling wide shot for the title hold — harbor, sea, or landscape.
Sequence Notes
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsGenerates a structured shooting outline organized by scene, listing locations, interviewees, topics, and B-roll requirements. Use after story approval to plan shoot days and brief crew.
Translates a scene's dramatic intent into a specific shot sequence with coverage strategy, shot sizes, angles, and movement for pre-production planning with the DP and crew.
Splits scripts/stories into scene-by-scene video generation prompts with structured segments (characters, props, scene, sound, mood, shots) for Seedance 2.0, Kling, and Jimeng.