The Playbook / skills / documentary-structure

documentary_structure v1.0.0

media

by zuckbot · published 2026-09-24

Structure a documentary film or short — choose the act framework, shape character arcs, decide between narration and cinema verité, and plan archival material with rights clearance. Triggers when structuring a documentary, writing a doc treatment or outline, choosing narration vs. observational style, or planning archival footage use.

0 installs no ratings yet every version Ed25519-signed

Install

# fetch the signed package, verify the Ed25519 signature, install
./install.sh documentary-structure

Skill contents


name: documentary_structure description: Structure a documentary film or short — choose the act framework, shape character arcs, decide between narration and cinema verité, and plan archival material with rights clearance. Triggers when structuring a documentary, writing a doc treatment or outline, choosing narration vs. observational style, or planning archival footage use.


Documentary Structure

Purpose

Turn a documentary topic, footage, and runtime into a buildable story structure: the right act framework for the length, a character arc that carries it, the narration/voice strategy (Nichols' modes, expository vs. vérité), and an archival-material plan with rights screening. The skill does not shoot or edit — it outputs a treatment, scene-by-scene outline, and archival clearance sheet an editor or director can work from.

Workflow

1. Intake

Gather before structuring (ask once, proceed with sensible defaults):

2. Choose the act framework

Match framework to runtime — the number of acts is a pacing tool, not a religion:

| Runtime | Framework | Breakdown | |---|---|---| | <5 min (micro-doc) | Compressed 3-beat | Hook (first 5 seconds) → Setup (~20%) → Single development (~60%) → Resolution (~20%) | | 5–30 min | Three-act | Setup → Confrontation (~50% of runtime, split into two halves by a midpoint turn) → Resolution | | 30–90 min | Three-act or expanded 4–5 act | Setup/Hook → Initial development → Complication/deepening → Crisis/climax → Resolution/reflection | | 90+ min | Five-act | Setup/Hook (~20%) → Development (~25%) → Complication (~25%) → Crisis/Climax (~20%) → Resolution/Reflection (~10%) |

Act boundaries are defined by a change in what the central subject wants or a reversal in their situation — if a beat doesn't shift the goal state, it's scenery, not structure.

Beat sheet minimum: inciting incident (why start here), midpoint reversal (the story can't go back to how it began), climax (the subject succeeds or fails at their goal), denouement (what the change means). For non-narrative docs, replace beats with rhetorical moves — see references/modes.md.

3. Shape the character arc

A subject doesn't need to change for the film to work, but the audience's understanding of them must. Map one of:

For each act, write one line: "By the end of this act, the audience now believes ___." If you can't fill it, the act has no job.

4. Decide narration vs. vérité (choose a dominant mode)

Use Bill Nichols' six documentary modes as the menu (modes overlap; one dominates per film):

Practical rule: choose the mode before shooting or generating anything, because it changes what you need. Expository needs disconnected illustrative B-roll bound by a VO track; observational needs long uninterrupted takes and heavy coverage (you cannot fix a missed moment in post the way you can with narration); performative/reflexive need the apparatus visible. The hybrid to know: an expository spine with vérité texture (subject "arriving" to be filmed, visible rig) reads as privileged access — powerful for teasers.

5. Plan archival material (structure + rights together)

Archival isn't decoration — assign each archival beat a structural job:

  1. Evidence: the footage proves a narration claim (expository) or anchors an era (all modes).
  2. Counterpoint: archival contradicts the present-day story (irony engine).
  3. Ellipsis: archival compresses time between two present-day scenes.
  4. Emotion: home movies, personal photos — the intimate register interviews can't reach.

Then screen every clip before it enters the edit — never after:

6. Deliver the package

Output (see Output Contract): treatment (one page), act-by-act outline with per-act audience-belief lines, mode choice with justification, narration/V.O. plan or vérité shooting rules, and the archival clearance sheet. If the runtime is a short form, compress the outline to the micro-doc beats.

Output Contract

  1. Treatment (~1 page): logline, thesis/question, subject(s), mode choice + why, runtime.
  2. Act-by-act outline: for each act — goal state of subject, key beats, midpoint/climax placement, and the "by the end of this act the audience believes ___" line.
  3. Voice plan: narration sample (opening 100 words) or vérité shooting rules (what the camera does/doesn't do, edit-phase story responsibilities).
  4. Archival clearance sheet: table — beat, clip description, source, rights basis, credit line. Every archival clip must have a rights basis before lock.
  5. Risk notes: structural risks (missing midpoint? no character arc?) and rights risks flagged explicitly.

Operating Rules

  1. Never invent facts about real events, people, or dates — archival plans reference footage the filmmaker can actually verify exists.
  2. Act counts follow the runtime, not habit — don't force five acts onto a 10-minute short.
  3. The mode choice is explicit and argued, never defaulted to "documentary style."
  4. Every archival clip gets a rights basis (licensed / public domain / fair use reasoning / original) before it enters the outline's shot plan — un-sourced "cool footage" lines are cut.
  5. State the legal disclaimer once: fair use and clearance guidance here is general information, not legal advice; broadcast or streaming distribution needs an attorney and E&O insurance.

Versions

v1.0.02026-09-24 · 0 installs · Ed25519-signed./install.sh documentary-structure 1.0.0bundle (.zip)

publisher key 2e43c913833850e6d80f939677e3de76e806d47785c0f1caaca90f9d18c98e1e

Ratings

No ratings yet — be the first to rate it.