Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs(skill): sharpen directing and authoring guidance
kashorindee36e24a53e
diff --git a/packages/caption-fine/README.md b/packages/caption-fine/README.mdindex df10498d..6c7a8692 100644--- a/packages/caption-fine/README.md+++ b/packages/caption-fine/README.md@@ -51,8 +51,8 @@ The Fine Schedule preserves the Caption projection's ProgramSpace, Narrative andThe renderer rejects any mismatched Space or document. Studio may expose lead, tail and handoff asordinary parameter edits, but Cue rectangles remain read-only semantic evidence.-Cue grouping is authored by Script segments, turns, Style changes and `||`; it is not delegated to-an LLM. Fine rejects word-specific Style runs. A caption whose Cue contains structural roles or+Script segments, turns, Style changes and `||` author Cue grouping. Fine rejects word-specific Style+runs. A caption whose Cue contains structural roles orrelationships—such as an independently arranged oversized keyword and supporting phrase—can usea new project Caption family. Reuse the common [Caption document, Program and timing](../caption/README.md),and implement the new schedule and rendering behavior in that package. This is ordinary componentdiff --git a/packages/gpt-image-kits/README.md b/packages/gpt-image-kits/README.mdindex f0adaae6..518e9875 100644--- a/packages/gpt-image-kits/README.md+++ b/packages/gpt-image-kits/README.md@@ -1,80 +1,44 @@# `@hypit/gpt-image-kits`-Data-only Text Templates for image direction. `phone-ugc-v1` carries one fixed iPhone-video capture-language, with current-shot direction supplied as ordinary Text. It introduces no model wrapper,-Provider, media generation, or activation hook.+`phone-ugc-v1` is a data-only Text Template for assembling image prompts. Its+[source](kits/phone-ugc-v1.svs) emits a fixed iPhone-video capture paragraph, followed by the supplied+Text slots, with paragraph separators. Import it as `@hypit/gpt-image-kits/phone-ugc-v1`.-## When to use phone-ugc+For creative direction, see the Image direction page in the Hypit Skill.-Use this template for images that should feel like frames from phone-shot social video: a creator,-an interview view, a lifestyle or product-use shot, or even an imagined person or animal inhabiting-a photographed world. It favors natural-looking lighting, fine texture, and a readable background-without depth-of-field blur. On GPT Image 2, this complete wording has repeatedly steered generated-images toward the visible character of ordinary phone-video frames. That is production evidence about-the model's behavior, not an API requirement or a universal rule for other models and visual forms.-A different capture language can use a different template or authored Text.+## Blocks and inputs-The capture paragraph is a versioned English text block and remains unchanged whenever this Kit is-selected. Its skin wording is part of that whole capture direction, including for an animal or-fantastical subject. When another subject or visual form genuinely needs a different capture language,-author another Text Template instead of conditionally rewriting this one. Portrait framing stays in-the `shot` input, while beauty, styling, material and scene-specific light stay in `direction`.+The capture block is fixed by this template version. Selecting a different capture language means+selecting or authoring another Text Template. The caller supplies the variable direction:-| Text slot | Meaning |-| --- | --- |-| `shot` (required) | Fluent direction for framing, comfortable camera distance, subject placement and its spatial reason, including space needed by later composition. Output aspect ratio and resolution belong to model parameters. |-| `direction` (required) | Fluent direction for the subject's presence, styling, physical state, setting, materials, intended feeling, and the palette and tonal relationship across the frame. |-| `references` (optional) | What each connected reference supplies and what this image should change. |+| Text slot | Required | Content |+| --- | --- | --- |+| `shot` | Yes | Camera view, framing, posture, gaze and interaction. |+| `direction` | Yes | Subject, styling, setting and intended appearance. |+| `references` | No | What each connected reference supplies or changes. |-Character, beauty, color, mood, subject position, camera distance and lighting remain fluent authored-decisions in `shot` and `direction`. The optional `references` text explains actual reference edges;-it does not create them or set model attributes. Describe a useful scene around an offset person, and-compose around later MG without asking the image model to draw that MG.+Each slot accepts an ordinary Text Output and may contain several paragraphs. The template produces+Text; the image Surface consumes it. Actual reference Resources and model parameters are connected+on that Surface.-Set aspect ratio and resolution through the model's parameters. For `@hypit/gpt-image`, the example-below uses `aspect-ratio="9:16"` and `resolution="2K"` on `gpt:Image`. Those parameters are the-authoritative output shape and size, so numeric values usually need no repetition in the prompt.-Keep directional camera or orientation language in `shot` when it materially clarifies the composition.+## Assemble the prompt-## Use it in a project--Import the package's public Source directly. The package manager or active Distribution owns its-installed version; the Source Closure reads the exported template without copying it into the video-project or executing package code.+Given authored Text Outputs `portrait-shot` and `portrait-direction`, this fragment assembles the+prompt and passes it to `gpt:Image`:```svml-<?svml using="@hypit/markup@1"?>-<svml>- <import as="text" from="@hypit/text@1"/>- <import as="gpt" from="@hypit/gpt-image@1"/>- <import as="ugc" source="@hypit/gpt-image-kits/phone-ugc-v1"/>+<import as="text" from="@hypit/text@1"/>+<import as="gpt" from="@hypit/gpt-image@1"/>+<import as="ugc" source="@hypit/gpt-image-kits/phone-ugc-v1"/>- <text:Value id="shot">- Generate a half-body view of a woman seated slightly to the right, comfortably near the camera,- with her face, shoulders, and gesturing hand clearly visible and naturally proportioned.- </text:Value>- <text:Value id="direction">- A Latina woman in her thirties has the striking beauty and commanding presence of a leading- Italian film actress, with broad shoulders and excellent head-to-shoulder proportions.- Her attitude says, "Stay out of my husband's business."- She wears a leopard-print fur coat over a black low-cut top, layered gold chains, and gold hoop- earrings. Her dark-brown hair falls in voluminous waves; her lipstick is classic red and her- long nails are deep red. She holds a handheld microphone while speaking to the camera, her free hand- gesturing naturally. She sits in a leather booth in an expensive Italian restaurant, with an- oil painting behind her, a bar farther back, and candles on a windowsill. Red upholstery and gold- accents establish the room, while the patterned coat and black top give her figure definition.- </text:Value>- <text:Render id="prompt" template={ugc.phone-ugc-v1}>- <text:Set name="shot" text={shot}/>- <text:Set name="direction" text={direction}/>- </text:Render>+<text:Render id="portrait-prompt" template={ugc.phone-ugc-v1}>+ <text:Set name="shot" text={portrait-shot}/>+ <text:Set name="direction" text={portrait-direction}/>+</text:Render>- <gpt:Image id="portrait" prompt={prompt} aspect-ratio="9:16" resolution="2K"/>-</svml>+<gpt:Image id="portrait" prompt={portrait-prompt} aspect-ratio="9:16" resolution="2K"/>```-When references are needed, add `gpt:Reference` children to `gpt:Image` and a `references` Text slot-describing those same inputs, for example “Use the first image for the person's identity; create-the new camera view described here.” A reference for identity alone does not lock its camera or pose.-Keep aspect ratio, resolution, model options, and Resource bindings on their owning Surfaces. The-ordinary Run selects Targets and Candidates; the Runtime Profile selects the execution Endpoint.+To explain reference inputs, add a `text:Set` named `references` to the Render. Connect those same+images through `gpt:Reference` children on `gpt:Image`. Omit the optional Set when no reference+direction is needed. The Text does not create Resource bindings.diff --git a/packages/script/README.md b/packages/script/README.mdindex 4d8254f9..8b183e6d 100644--- a/packages/script/README.md+++ b/packages/script/README.md@@ -61,7 +61,8 @@ CaptionDocument contracts.### Script vocabulary- **Segment**: a named structural passage, written `<opening>...</opening>`.-- **Role Cue**: a speaker turn, written `<ALICE>...</ALICE>` or as a bare role tag in a Segment.+- **Role Cue**: a speaker turn, written as a bare tag such as `<ALICE>` inside a Segment. The next+ Role Cue or the Segment close ends that turn.- **Dual Text**: one authored speech span with separate display and spoken projections, written`<display text | spoken text>`.- **Selection marker**: a named semantic range, written `@name ... @/name`.@@ -69,11 +70,12 @@ CaptionDocument contracts.- **CaptionDocument**: the Script-owned caption truth; it contains **Display Words**,**Alignment Units** and **Cue Breaks**. It contains no seconds or frames.- **Token attribute**: a flat postfix display-word annotation such as `really{emphasis}` or- `really{emphasis,keyword}`. It becomes `CaptionDisplayWord.attributes`; it is not a Selection and- does not carry timing.+ `really{emphasis,importance=2,tone=warm}`. Values may be strings, finite numbers or booleans. It+ becomes `CaptionDisplayWord.attributes`; it is not a Selection and does not carry timing.Within Dual Text, an unescaped `@` is legal only on the spoken side. The display side is literal; write-`\@` if an at-sign must be shown. `||` is an authored Caption Cue Break and must occur between+`\@` if an at-sign must be shown. An empty display side, such as `< | spoken words>`, keeps the speech+tokens and omits them from Caption. `||` is an authored Caption Cue Break and must occur betweencomplete Alignment Units.## Segments, turns and Cues are different boundariesdiff --git a/skills/hypit/SKILL.md b/skills/hypit/SKILL.mdindex 1ab58e49..81a7f632 100644--- a/skills/hypit/SKILL.md+++ b/skills/hypit/SKILL.md@@ -32,8 +32,17 @@ for the target's words and intention. Selections can carry an explanation or comcarry an answer or payoff. This is Hypit's strong production prior. Use explicit clock timing wherethe work calls for it, and use named wordless Segments when action or silence carries the passage.+Creative direction and installed expression answer different questions. When the work needs a+generated picture or video, A-roll, B-roll, Caption, MG, voice or sound relationship, read the Craft+that owns what it should accomplish. Then use installed vocabulary and package-local documentation+for the exact Surface, inputs and limits. Knowing how to call a model or component does not supply the+directing judgment, and Craft does not replace the installed declaration.+Treat existing project prompts and Recipes as earlier directing choices. Compare their assumptions+with the current Brief, Treatment and relevant Craft, and carry them forward while the same artistic+relationship still serves this work.+GPT Image 2 and Seedance 2 Mini at 720p are the usual starting points for generated pictures and-performances, balancing capability and cost. Choose for the actual work; the image and performance+performances, balancing capability and cost. Choose for the actual work; the image and videocrafts explain resolution and duration choices.## Establish the working crew@@ -127,8 +136,16 @@ close behind the work.| understanding a reference video or link | `references/creation/reference-video.md` || defining the target: what the user asked for, and what the new piece will be | `references/creation/brief.md` || cloning with supplied faces or products, changing the Script, language, length, or combining references | `references/creation/transformations.md` |-| estimating speech duration with `hypit measure`, Script syntax, Cues, Selections, Moments, and semantic time | `references/creation/script-and-time.md` |+| writing or revising `<script>`: Segments, Roles, Dual Text, `||` Caption Cues, word attributes, Selections, Moments, empty passages, or measured delivery | `references/creation/script-and-time.md` || project layout, picking work back up, or handing an editable production to someone else | `references/creation/project-files.md` |+| directing a generated person, setting, product, B-roll image, camera view, visual reference or image prompt | `references/playbooks/craft/image-direction.md` |+| directing generated video, visible performance, silent action, camera behavior, cuts or request duration | `references/playbooks/craft/video-direction.md` |+| deciding who is A-roll, recurring voice identity, covered performance or independent narration | `references/playbooks/craft/voice-and-performance.md` |+| designing B-roll coverage, montage, short display windows or editorial handoffs | `references/playbooks/craft/b-roll.md` |+| designing Caption reading rhythm, styling, placement or a new Caption family | `references/playbooks/craft/captions.md` |+| designing MG, a board, cards, graphic state, hierarchy, palette or reveals | `references/playbooks/craft/graphic-compositions.md` |+| deciding which generated images or videos should depend on which references | `references/playbooks/craft/generated-dependencies.md` |+| directing music, sound effects, ambience, gain, ducking or the completed mix | `references/playbooks/craft/sound-mix.md` || writing Sources, Recipes, and Runs, reusing produced work, adding a component | `references/production/authoring.md` || imports, output references, literal values or Recipe rules | `references/production/source-syntax.md` || assembling reusable prompt wording or authoring a Prompt Kit | `references/production/prompt-kits.md` |@@ -148,7 +165,7 @@ close behind the work.| opening Studio, understanding its views and edits, or adding a component Companion | `references/production/studio.md` || Film assembly, picture and sound, final rendering or a selected frame interval | `references/production/rendering.md` || judging the preview or finished Result and deciding what to fix | `references/production/review.md` |-| the shape of a format, or one craft problem: image direction, Caption, B-roll, voice, sound, graphics | `references/playbooks/index.md` |+| recognizing a whole-work format, combining formats, or discovering another directing Craft | `references/playbooks/index.md` |Several rows can apply at once; read what the work actually asks for, and return to a room whenever apreview or Result raises its question again. These references explain production use; installeddiff --git a/skills/hypit/references/creation/script-and-time.md b/skills/hypit/references/creation/script-and-time.mdindex b83c18fc..a1434934 100644--- a/skills/hypit/references/creation/script-and-time.md+++ b/skills/hypit/references/creation/script-and-time.md@@ -1,9 +1,10 @@# Script and semantic time-Read this when structuring Script, balancing spoken delivery across generated Takes, or attaching-pictures, Captions, MG, Effects, and Audio to what is said. It also explains how a passage with no-spoken words receives semantic boundaries. This page contains the stable author-facing Script-spellings; the installed `@hypit/script` package owns parser edge cases.+Read this before writing or revising `<script>`, when balancing spoken delivery across generated+Takes, or when attaching pictures, Captions, MG, Effects, and Audio to what is said. It also explains+how a passage with no spoken words receives semantic boundaries. This page contains the complete+stable author-facing Script vocabulary; the installed `@hypit/script` package owns parser validation+and edge cases.[Source syntax](../production/source-syntax.md) covers the surrounding imports, references, Recipesand Runs; [Tracks](../production/tracks.md) covers the consumers of Script meaning.@@ -22,7 +23,8 @@ Use Script's distinct authoring concepts for distinct jobs:- a **Segment** is a named structural passage whose accepted media can become one SemanticTake;- a **Role Cue** says who speaks a turn without creating a character or choosing a voice;- **Dual Text** gives one authored unit separate display and pronunciation text;-- `||` places an authored **Caption Cue Break** between complete Alignment Units;+- `||` says that one on-screen **Caption Cue** hands off to the next after a complete Alignment Unit;+- a **word attribute** gives a Caption family an authored role on one displayed word;- a **Selection** names a semantic range;- a **Moment** names a semantic point.@@ -35,26 +37,44 @@ Use Script's distinct authoring concepts for distinct jobs:```Here the viewer reads `Hypit` while the performance says `hi pit`. The pair is one indivisible-Alignment Unit. `||` starts a new Caption Cue after it, `proof` remains one semantic range, and-`claim` is a semantic point that other layers can use.+Alignment Unit. `||` ends one on-screen Caption Cue after that unit and lets the next Cue begin with+`work`; `proof` remains one semantic range, and `claim` is a semantic point that other layers can use.++A Cue is a timed block of displayed speech, not a line of text. Its Caption family and Recipe may+wrap that block over one or more lines, reveal or highlight its words, and give the block an entrance,+exit or handoff. Segment boundaries, Role turns and Caption Style changes already separate Cues.+Use `||` when the same Segment, turn and Style still needs another deliberate reading handoff. The+[Caption craft](../playbooks/craft/captions.md#design-cue-rhythm-with-the-caption-system) owns how the+picture, language, family and Recipe shape that decision.The author-facing forms are:| Form | Meaning || --- | --- |-| `<opening>...</opening>` | A Segment named `opening`. |+| `<opening>...</opening>` | A Segment named `opening`; all spoken prose belongs inside a Segment. |+| `<pause/>` | A self-closing Segment with identity and boundaries but no words. || `<HOST>` | A Role Cue inside the current Segment; it applies until another Role Cue or the Segment end. || `<display text \| spoken text>` | One Dual Text unit with separate visible and pronounced wording. |-| `||` | A Caption Cue Break between complete Alignment Units. |-| `word{emphasis,keyword}` | Flat attributes on one complete display word for a Caption family to interpret. |+| `< \| spoken text>` | Spoken words that keep semantic timing while contributing no visible Caption words. |+| `||` | A Caption Cue handoff between complete Alignment Units. |+| `word{emphasis,keyword}` | Boolean attributes on one complete display word for a Caption family to interpret. |+| `word{importance=2,tone=warm}` | Named string, number or boolean attribute values on that display word. || `@proof ... @/proof` | A Selection: one named semantic range. || `@claim!` | A Moment: one named semantic point. |-A Role Cue is optional, and closing a Segment resets its Role. A Segment can contain several Role-turns without requiring several generated Takes. Dual Text can contain several visible or spoken-words on either side; its display side feeds Caption and its spoken side feeds pronunciation. Place-Cue Breaks around the complete unit, never inside it. Inside Dual Text's display side, use `\@` when-the visible text itself needs an at-sign.+A Script contains one or more uniquely named lower-case Segments. A paired Segment carries prose;+the self-closing form carries a wordless passage. A Role Cue is a bare turn marker rather than a+paired element: the next Role Cue begins the next turn, and closing the Segment ends the final turn+and resets its Role. When a Segment uses Roles, place the first Role before that Segment's first+spoken text. One Segment can contain several Role turns without requiring several generated Takes.++Dual Text can contain several visible or spoken words on either side; its display side feeds Caption+and its spoken side feeds pronunciation. An empty display side intentionally omits those spoken words+from Caption while keeping them in the Narrative and semantic timing. Selections and Moments can be+placed on the spoken side because that side owns the speech anchors. Place Cue Breaks around the+complete Dual Text unit, not inside it. Attributes for a displayed Dual Text word belong on the+display side before the pipe. Inside that display side, use `\@` when the visible text itself needs an+at-sign.Script comments use ordinary Markup comments outside the prose:@@ -64,10 +84,18 @@ Script comments use ordinary Markup comments outside the prose:```Reserved Script punctuation remains literal when escaped: `\@` produces `@`, `\<` produces `<`,-`\>` produces `>`, `\|` produces `|`, and `\\` produces `\`. Inside Dual Text, the first-unescaped `|` separates display from pronunciation; write `\|` for a literal pipe and `\|\|` for-two literal pipes. These escapes belong to Script prose, while structured Source attributes and-elements use the Markup escaping described in [Source syntax](../production/source-syntax.md).+`\{` produces `{`, `\}` produces `}`, `\|` produces `|`, and `\\` produces `\`. A plain `>` needs+no escape in ordinary prose; inside Dual Text, `\>` keeps it from closing that unit. A single `|` in+ordinary prose is literal; `||` is the Caption Cue handoff. Inside Dual Text, the first unescaped `|`+separates display from pronunciation; write `\|` for a literal pipe and `\|\|` for two literal pipes.+These escapes belong to Script prose, while structured Source attributes and elements use the Markup+escaping described in [Source syntax](../production/source-syntax.md).++Script derives speech tokens from words and numbers. Punctuation remains attached to the displayed+word it belongs with and does not create another speech time unit. CJK prose commonly contributes+one Han, Hiragana or Katakana character per lexical unit; compounds, decimal numbers and the spoken+side of Dual Text preserve their own lexical structure. This is why Cue breaks, word attributes and+semantic markers attach to complete authored units instead of punctuation or visual line positions.## Use the Script's deliberate projections@@ -107,19 +135,6 @@ conversation. One continuous narration can carry many B-roll changes through Selcan deliberately use several Takes driven by the same character-and-scene image; a natural cut isoften part of its appeal. A Role change or `||` does not require another generation.-## Author Caption rhythm, not a word-count rule--Caption Cues express how the viewer should read the displayed speech. Break them at natural phrase,-emphasis, speaker, layout, and motion boundaries. A large display or rapid word-by-word system may-need very small Cues; a restrained lower Caption may hold a longer phrase. Inspect the actual style and-canvas.--Keep `||` between complete Alignment Units; it cannot split Dual Text. Script emits one-`CaptionDocument` containing display words, alignment units, attributes, and authored Cue breaks but-no seconds or frames. Caption packages later join that document to actual semantic timing. Independent-titles, labels, steps, and poster text normally belong to Typography, Text Track, UI, or MG rather than-being forced into spoken Caption Cues.-## Measure before choosing durationsFor a new or revised A-roll performance, choose time from the target's words, delivery, and action.@@ -145,8 +160,8 @@ Let that estimate inform the shape of the passage. A short line may belong withbenefit from a little fuller wording, or leave room for a meaningful action. A long passage may readbetter with tighter copy or a split at a natural change of thought. Preserve the intended meaning andenergy while finding a performable shape, then measure the affected wording again. The-[Seedance craft](../playbooks/craft/seedance-directing.md#size-the-request-around-the-delivery) applies-this judgment to its model range.+[Generated video direction](../playbooks/craft/video-direction.md#size-the-request-around-the-delivery)+applies this judgment to the selected model's request range.Measurement balances the intended speaking density and sizes generation; it supplies no timelineanchors. Once a Take is accepted, normalize it, align its actual speech to its Script Segment, and@@ -177,6 +192,17 @@ adjacent semantic boundary:| `@name!` | Place a Moment at the next word's start. || `~@name!` | Place a Moment at the previous word's end. |+Markers may sit between or outside Segments when the meaning crosses structural passages. For+example, this Selection owns the complete Script program rather than borrowing the first and last+word boundaries:++```svml+~@whole+<opening><HOST>First thought.</opening>+<answer><HOST>Final answer.</answer>+@/whole~+```+At a Script or Segment edge, the corresponding structural boundary remains available even whenthere is no neighboring word. Thus `@videos videos @/videos` covers exactly that word. For adjacentB-roll windows that should also own the pause between words, choose which neighboring Selectiondiff --git a/skills/hypit/references/playbooks/craft/b-roll.md b/skills/hypit/references/playbooks/craft/b-roll.mdindex 31874f5e..af9cdee3 100644--- a/skills/hypit/references/playbooks/craft/b-roll.md+++ b/skills/hypit/references/playbooks/craft/b-roll.md@@ -115,5 +115,5 @@ serve that sensation. Synchronized generated sound, recorded sound or separatelyeach be appropriate. [Sound and mix](sound-mix.md) covers their relationship.When a work is genuinely speech-free, its visual, musical and action relationships still need-authored semantic boundaries. [Media preparation](../../production/media.md#wordless-passages-use-media-boundaries)+authored semantic boundaries. [Media preparation](../../production/media.md#empty-segments-use-their-media-boundaries)owns how actual media supplies them.diff --git a/skills/hypit/references/playbooks/craft/captions.md b/skills/hypit/references/playbooks/craft/captions.mdindex e9e08951..8215aff8 100644--- a/skills/hypit/references/playbooks/craft/captions.md+++ b/skills/hypit/references/playbooks/craft/captions.md@@ -13,6 +13,28 @@ For implementation of a new visual family, read[Caption authoring](../../production/caption-authoring.md). That guide keeps the common text/timingchain and shows where the new family owns scheduling and rendering.+## One data contract, three presentation layers++Script publishes one `CaptionDocument`: ordered display words, complete Alignment Units, speaking+Roles, word attributes and authored Cue handoffs. Caption joins it to the real SemanticTrack. That+common typed relationship is what makes the result Caption; an official renderer is not the+definition. A project package can provide another Caption family while keeping the same Script words+and measured speech evidence.++Direct the presentation through three related layers:++| Layer | What it decides |+| --- | --- |+| **Family** | The structural visual language and scheduling behavior the Caption can express: uniform flowing words, independently arranged phrases, speaker-attached shapes, or another authored relationship. |+| **Recipe and resolved Style** | One coherent treatment within that family. An SVS Recipe gathers a useful combination; the family's Style Surface resolves it with fonts or other explicit resources. Role or Selection applications can choose among those Styles. |+| **Parameters** | The individual decisions inside that treatment: placement and anchors, usable width, wrapping, typography, Paint and boxes, active-word response, Cue motion, reveal, lead, tail and handoff. |++The installed family vocabulary owns exact parameter names and accepted values. Craft owns how the+combination serves this picture and this reading rhythm. Keep a proven production treatment in its+project `.svs`; a set that has earned reuse across works can become an ordinary versioned data package+under its owner's scope. Such a collection preserves the family, Recipe and intended use together+rather than turning isolated parameter values into universal defaults.+## Keep wording and timing in their ownersScript owns display words, speaking Roles, Dual Text units, attributes and `||` Cue Breaks. Its@@ -45,17 +67,63 @@ Use the owning package README and `hypit vocabulary @hypit/caption-fine` for curKeep one coherent interpretation of the Script across speakers and styles; different colors do notrequire unrelated transcripts or separately invented timing.-Fine's uniform-flow layout is a particular family. When the work needs new structural relationships-within a Cue, create a project Caption family consuming the common Caption data and semantic timing.-A new layout is normal component authorship. [Track authoring](../../production/track-authoring.md)+Fine's uniform-flow layout is a particular family and a useful broad implementation. When the work+needs new structural relationships within a Cue, create a project Caption family consuming the common+Caption data and semantic timing. Word attributes and semantic Selections can carry the authored roles+that family interprets; its own schedule and renderer can give those roles distinct arrangement and+animation. A new layout is normal component authorship. [Caption authoring](../../production/caption-authoring.md)explains the boundary.-## Design reading rhythm with the picture+## Design Cue rhythm with the Caption system++A Cue is one timed block of displayed speech. Its family and Recipe determine what that block looks+like; Script's `||` determines an additional handoff between blocks inside the same Segment, speaking+turn and Style run. Those other boundaries already form new Cues. A visual line is different: Fine+may wrap one Cue over several lines without another `||`.++Choose the grouping from language and picture together. Let one Cue carry a coherent phrase or+thought that the viewer can grasp while still watching the performance. Preserve words whose meaning+depends on each other, and give a payoff or contrast its own handoff when the visual treatment makes+that separation useful. Keep a name, negation, article and noun, preposition and object, phrasal verb,+or quantity and unit together when separating them would make either screen state harder to read.++For the compact Fine treatments common in short-form UGC, begin with two to four displayed words per+Cue, or an equivalently brief reading unit in writing systems that do not separate words with spaces.+Count what Caption displays: the spoken side of Dual Text does not make the visual block longer. This+range is a strong drafting prior for a quickly handed-off, animated Caption; the actual language,+delivery, font, width, motion and Canvas decide the finished grouping. Let a tightly bound phrase run+longer when its meaning would suffer from another handoff.++With Fine's uniform-flow family, direct the common Cue to remain on one line by considering its+grouping together with the Recipe's font size, usable width and word gap. A stable line lets each+handoff replace one readable block without repeatedly changing the block's height and the viewer's+reading position. A Caption family designed around a two-line stack, an oversized keyword with a+supporting phrase, or another internal composition owns that relationship itself; its intentional+line structure is not a reason to add another `||`.++For example, a compact Fine treatment can begin with this phrase rhythm:++```svml+<explanation><HOST>+ One reference || can rebuild ||+ the shots and pacing, ||+ the captions and effects, ||+ around your product.+</explanation>+```-Break Cues at meaningful phrases, emphasis, speaker changes and the needs of the chosen visual-composition. `||` goes between complete Alignment Units and cannot split Dual Text. A short phrase-can stand alone; a longer readable Cue can be correct. Fine's line wrapping and word-per-line setting-are layout choices.+Its Cues contain two, two, four, four and three displayed words, while articles remain with their+nouns and each list pair stays intact. The same sentence can justify another grouping when a+different family makes a contrast, keyword or reaction the visual event. The sentence supplies+semantic structure; the chosen presentation says how much of that structure should share one screen+state.++Use Studio or a rendered interval to see the Cue with actual speech. Repeatedly flashing tiny groups+usually means the viewer is being asked to reacquire text too often; an overfull block usually means+the language, Recipe or family is asking one visual state to carry too much. Change `||` when the+reading unit is wrong. Change the Recipe when the reading unit is right but its size, wrap, placement+or motion is wrong. Change the family when the desired relationships cannot be expressed by that+family's structure.Choose font, size, width, line height, contrast and motion together. If a Cue overflows, inspect bothits authored grouping and its actual Style; do not assume every overflow has the same cause. Lead,diff --git a/skills/hypit/references/playbooks/craft/compositing.md b/skills/hypit/references/playbooks/craft/compositing.mdindex 3d62ce23..02c35139 100644--- a/skills/hypit/references/playbooks/craft/compositing.md+++ b/skills/hypit/references/playbooks/craft/compositing.md@@ -96,6 +96,33 @@ the final layout. Editorial graphics remain separate layers and are not objectsperson to see, touch or point toward. [Image direction](image-direction.md#frame-the-image-for-what-it-will-become)owns the camera-image wording; [Spatial layout](../../production/spatial.md) owns Frame, fit and crop.+### Prepare a moving cutout plate++When the intended A-roll presentation is a moving cutout, a chroma-backed camera image is a useful+way to prepare the performance. Direct the person's identity, appeal, styling, framing, visible body+extent and performable presence with the same care as another A-roll image. Give that photographed+world a continuous, evenly lit chroma backdrop whose color separates clearly from the person's hair,+clothing, skin, microphone and other carried objects. Green is a common starting point; another flat+chroma color can provide better separation when green belongs to the subject.++This image is a production plate for the speaking performance. Use it as the actual image reference+for the video generation, direct the person's Script delivery and physical performance, and keep the+backdrop visually stable through the clip. The resulting moving video then follows one relationship:++```text+chroma-backed camera image+ → generated speaking performance+ → moving-video matting+ → alpha-preserving normalization+ → SemanticTake+ → Speech Track cutout presentation+```++The chroma backdrop establishes subject separation rather than the final story setting. The final+background, screen, B-roll or MG belongs to the editorial composite, where it can change without+regenerating the accepted performance. [Image direction](image-direction.md) still owns the person's+identity, framing and useful performance state; the matting section below owns the processed video.+## Inset, cutout and flattened composite are distinct choicesA speaking rectangular inset, circular inset or normalized cutout can be presented directly bydiff --git a/skills/hypit/references/playbooks/craft/examples/conversation-images.md b/skills/hypit/references/playbooks/craft/examples/conversation-images.mdindex ab0ecdc4..58090da6 100644--- a/skills/hypit/references/playbooks/craft/examples/conversation-images.md+++ b/skills/hypit/references/playbooks/craft/examples/conversation-images.md@@ -24,6 +24,11 @@ The Kit supplies the capture paragraph once. Set the output aspect ratio, such amodel; do not spend prompt attention repeating it. Without the Kit, prepend the paragraph to theselected direction. Connect the stated reference images as actual model inputs.+These renditions preserve complete production directions as evidence, including additional+time-of-day, brightness, exposure, or lighting language that belonged to those particular shots.+For a new phone-video image, begin with the current Craft and the Kit, then carry such direction when+the intended scene itself needs that visible fact.+## Restaurant podcast views### Main host: establish a person and a place together@@ -62,8 +67,8 @@ entry and visible background sector change. “Symmetrical” describes the convnot a horizontally flipped copy of the same wall.```text-Generate a complementary half-body podcast photograph, with the pose and composition corresponding-to the reference from the opposite side. The person now sits toward the left and looks right.+Generate a fully symmetrical counterpart to the reference podcast half-body photograph, keeping the+pose and composition correspondingly symmetrical. The person now sits toward the left and looks right.The microphone extends from the right and still reads HYPIT. Keep the lighting natural.The setting is still outside the same Korean restaurant, but the background contains a different@@ -146,11 +151,6 @@ The room has a warm, modern Korean interior. Real afternoon sunlight illuminatesbright golden light, and her face also has believable natural illumination.```-These cases intentionally use different exposure situations. Their light/dark and color words are-preserved as authored choices. [Image direction](../image-direction.md) explains how to judge the-combined palette and large bright areas when making a new image while retaining a scene's intended-light.-## Optional split-screen openingInputs: both final host views. The output shape remains a model parameter.diff --git a/skills/hypit/references/playbooks/craft/examples/image-direction.md b/skills/hypit/references/playbooks/craft/examples/image-direction.mdindex 0311d447..2aa4f0a8 100644--- a/skills/hypit/references/playbooks/craft/examples/image-direction.md+++ b/skills/hypit/references/playbooks/craft/examples/image-direction.md@@ -1,73 +1,82 @@# Image direction examples-Read this alongside [Directing generated images](../image-direction.md) when learning the actual-prompt language and aesthetic choices for phone-video images.+Read these with [Directing generated images](../image-direction.md) for complete phone-video image+directions and visual examples.-The record-store case pairs its exact English production prompt with its output. The other three-pictured cases pair their outputs with faithful English translations of the Chinese production-prompts. Framing is consolidated into `shot`, and output orientation is moved to the external model-settings. The translations illustrate the direction; only a shown output establishes what a submitted-prompt produced.+The first paragraph is the Kit's fixed capture direction. The rest describes the picture in ordinary+language and can be assembled through its `shot` and `direction` slots. Use `aspect-ratio="9:16"`+and usually `resolution="2K"` on `gpt:Image` for these full-screen portraits. The [Craft](../image-direction.md#use-a-concrete-capture-direction)+shows the Kit assembly. Existing production wording, including particular lighting choices, remains+with the result it describes.-In each prompt, the first paragraph comes from the Kit's fixed capture block, the next is the-`shot` input, and the remaining paragraphs are the `direction` input. The pictured character studies-use no reference media; the supplied-presenter variation below adds an identity reference. A work can-explain connected images through the optional `references` input.-[Directing generated images](../image-direction.md#use-a-concrete-capture-direction)-shows the SVML assembly.+## Goth girl outside a Korean cafe-The suggested settings for these prompts are `aspect-ratio="9:16"` and `resolution="2K"` on-`gpt:Image`. These are external model settings; the prompt describes the composition within that-shape without repeating it.+-The frontal half-body view and microphone belong to this series of versatile speaking images.-Speaking and loosely gesturing describe an ongoing presence, leaving the later video to direct the-particular line and gesture. Carry the capture language into another useful shot without-automatically carrying this staging. Read examples whose directing question is relevant.+Production example: the prompt below was used directly to generate the shown image.-## Shanghai record-store owner: one coherent person+The intended picture is a striking, sweet-but-rebellious goth girl casually talking to the viewer+outside a Korean café. Idol beauty sets the strength of attraction; blunt bangs, feline makeup,+jewelry and a spiked cap give it a particular character. Textured wood, coral-red accents and plants+establish the place and palette. The half-eaten bingsu on the left both balances her rightward position+and suggests a café visit already underway.++In the result, wood belongs to a shopfront with openings and a recessed entrance. Sidewalk+seating, plants and the foreground dessert establish different distances and a café in use. The red+architectural detail and green foliage give color a physical role. Much of the background is still+wall: its construction and relationship to the rest of the place make it convincing. These are useful+qualities to seek in another setting, with the few spatial anchors that belong to that new view.++The [four paragraph roles](../image-direction.md#compress-the-idea-into-decisive-anchors) are visible+here. In the Kit, use the second paragraph for `shot` and the final two for `direction`.++Production prompt:++```text+A photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.++Generate a vertical close half-body photo of an exceptionally beautiful young woman sitting slightly to the right, near the camera, with her body kept within the frame. She holds a handheld microphone and speaks to the camera, her free hand making a conversational gesture. She has a sweet, slightly rebellious charm, as though casually sharing her take with a friend. Her face is in the upper-middle part of the frame, slightly to the right.++She looks Japanese-American and is extraordinarily beautiful, like a top Korean girl-group idol. She has a very small face, very broad shoulders, excellent head-to-shoulder proportions and very fair skin. Her hair is long, black and straight, with blunt bangs. She wears soft goth makeup with a captivating feline look around the eyes, beautiful silver earrings, a choker and layered necklaces. She wears a black goth-style T-shirt and a baseball cap decorated with silver spikes, with HYPIT in uppercase Gothic lettering.++She is seated outside a relaxed street-side café in Korea. Behind her are beautifully textured wooden exterior walls with a pronounced grain, coral-red architectural accents, some green plants and a few other tables. A half-eaten grape bingsu sits on the table in the lower-left corner. Wood brown forms the main backdrop, with coral red and leafy green as accents.+```++For subsequent reusable frontal speaking images, the+[idle guidance](../image-direction.md#choose-an-idle-state-for-the-encounter) adds an explicit pose:+"Her face points straight toward the lens, with no head tilt or rotation."++### A centered standing version++This variation demonstrates the paragraph roles and has not been generated.++Keep the capture and casting paragraphs above. The person can keep her strong appeal, proportions+and speaking attitude while a new encounter paragraph places her standing in the center. Update the+place paragraph to match that stance. A close half-body crop still suits this speaking image.++Replacement encounter and place paragraphs:++```text+Generate a close half-body photo of an exceptionally beautiful young woman standing in the center of the frame, comfortably near the camera, with her shoulders and upper body visible. Her face points straight toward the lens, with no head tilt or rotation. She holds a handheld microphone and speaks to the camera, her free hand gesturing naturally. She has a sweet, slightly rebellious charm, as though casually sharing her take with a friend.++She stands outside a relaxed street-side café in Korea. The wooden shopfront has a recessed entrance, coral-red architectural details and green plants beside the doorway. A café table beside her holds a half-eaten grape bingsu, with a few other seats farther along the pavement.+```++The four paragraphs keep their roles; the scene determines their particular framing and objects.++## Shanghai record-store owner-The casting idea is a beautiful woman with distinctive taste, at ease in a place she knows deeply.-The following choices explain the prompt's directing intent as a whole.--- **Beauty with a particular character.** “Exceptionally beautiful” and “the striking appeal of a- top girl-group idol” state the strength of the desired appeal. “The cool presence of an independent- film actress” gives it a particular character. These describe complementary qualities of one person;- they do not request a collage of different faces. “Shanghai” locates her social world, but the city- name alone does not supply this casting direction.-- **Expertise expressed as presence.** Recognizing a record from its first two seconds conveys ease,- confidence, and a relationship to music without prescribing a facial pose. The closing sentence- makes her someone giving a personal recommendation to the viewer. That relationship gives the- image a more specific human intention than a beautiful person simply occupying a shop.-- **Styling and surroundings that agree.** The neat bob, knitted polo, silver hoops, and headphones- support her composed, music-literate persona. Album sleeves and a handwritten recommendation card- make this her working shop. Each detail helps the same person become legible.-- **A palette that lets her stand out.** Jade-green clothing and walnut shelves establish distinct- subject and setting colors. The face stays clearly lit while the shelves retain shadows and detail.- Color, material, and lighting work together; there is no request to brighten the whole room.-- **A body situated in the room.** The lower-left turntable gives the rightward placement a physical- reason. Comfortable proximity, visible shoulders and upper body, and explicit head-to-shoulder- proportions work together to keep her present without asking for an extreme close-up. The fixed- iPhone-video paragraph supplies the capture language for this highly attractive, deliberately styled- person.--For a different character, carry forward the relationship between these choices. A different persona-may call for flowing hair, workwear, a bustling outdoor setting, or another palette. A bob, green-clothing, walnut shelves, and two beauty comparisons are not a reusable formula for an attractive-woman. Keep the aesthetic direction forceful while making its visible details belong to the new person.--In the result, her face draws attention between the black bob, green knit, and wooden shelves.-The knit stitches, headphone surfaces, silver hoops, and reflections on the record sleeves give-different materials their own visible character. Small highlights are visible on her nose and lips.--The direct gaze, open mouth, microphone, and forward gesturing hand make the frame read as an ongoing-conversation. The turntable occupies the lower left, while the records and handwritten recommendation-cards make the shop legible around her. The camera sits slightly above her eye line, while one-shoulder meets the right edge of the image. The complete prompt follows.--Complete English prompt:+Here the striking beauty and cool music-lover presence have a different expression: a bob, jade-green+knit, headphones, and a few record-shop details. Green clothing and walnut shelves distinguish the+person from the setting; the lower-left turntable balances her rightward placement. Recognizing a+record from its first two seconds gives her confidence a vivid social meaning.++The complete prompt below belongs to this particular portrait. Carry that decisiveness into another+character while choosing the face, clothing, setting, and colors that suit the new image.++Complete prompt:```textA photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.@@ -112,21 +121,20 @@ Look at that image and direct its appeal within the target work, using the same-The beauty comparison and the attitude give this person a vivid social presence. Fur, layered gold,-red lips, leather seating, and an expensive restaurant reinforce it. The production prompt-names these materials without adding instructions for leather grain, fabric folds, or metal-reflections. Its final sentence places her in the social world of a mob wife meeting her girlfriends.+The beauty comparison and "Stay out of my husband's business" give this person a vivid presence.+Fur, layered gold, red lips, and an expensive restaurant reinforce it. Simple material names leave+the model room to render their ordinary surfaces. Red and gold establish the room's atmosphere.The deep-red nails and dark-brown hair below preserve the production prompt that belongs to thisexample. Apply the current palette guidance when directing a new image.-Complete English prompt:+Complete prompt:```textA photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.Generate a close half-body image of a Latina woman in her thirties, seated slightly to the right and near the camera. Keep her body within the frame. Her face is directed straight ahead without any tilt or rotation, and the lower part of her body is visible and unobstructed.-She holds a handheld microphone in one hand and speaks to the camera, while her other hand gestures. Her commanding attitude says, “Stay out of my husband's business.” She is exceptionally beautiful, with the intense beauty of a top Italian actress and the stunning appeal of an iconic Italian screen star in her youth. She has broad shoulders, excellent head-to-shoulder proportions, and a larger-than-life presence.+She holds a handheld microphone in one hand and speaks to the camera, while her other hand gestures. Her commanding attitude says, “Stay out of my husband's business.” She is exceptionally beautiful, with the intense beauty of a top Italian actress in her youth. She has broad shoulders, excellent head-to-shoulder proportions, and a larger-than-life presence.She wears a leopard-print fur coat over a black low-cut top, several chunky gold chains layered around her neck, and large gold hoop earrings. Her long nails are deep red. Her dark-brown hair falls in voluminous waves; she wears classic red lipstick and bold but clean eye makeup. She sits in a leather booth in an expensive-looking Italian restaurant. An oil painting hangs on the wall behind her, a bar is visible farther back, and candles stand on a nearby windowsill.@@ -138,12 +146,10 @@ The restaurant's background palette is mainly red and gold. It feels like an upsThe boss's authority organizes the picture. A round face, large belly, crooked tie, straining suit-buttons, and undersized cat tree make that authority funny. The actual prompt obtains its character-appeal through those relationships; it adds no general handsome-animal requirement or individual-fur-detail. It names a leather chair and a gray-and-orange textured office palette without cataloging-fabric weave or leather grain. The capture paragraph supplies the photographic premise.+buttons, and undersized cat tree make that authority funny. A leather chair, office window, laptop,+and mug establish the workplace; gray and orange establish the palette.-Complete English prompt:+Complete prompt:```textA photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.@@ -162,12 +168,10 @@ The office's background design combines gray and orange textures. It looks likeThe mermaid identity, explicit beauty, and friendly curiosity direct the person. Wet hair, shells,-real pearls, shafts of underwater sunlight, and sand place her in a specific physical world. The-actual prompt names those states and objects, then finishes by saying that she really appears to be-sitting underwater. It leaves ordinary surface behavior for the model to resolve, without adding-separate instructions about shell texture or contact against the skin.+pearls, coral, and fish establish the underwater world. Sea blue and coral orange give it a color+relationship. The final sentence reaffirms that she appears to be physically sitting underwater.-Complete English prompt:+Complete prompt:```textA photograph with the texture of real iPhone footage, captured as a single frame from a video actually shot on an iPhone. The image looks real, without an oily, overprocessed finish, and has the texture of video footage. The background is clearly visible, with no depth-of-field blur. Skin texture is natural and fine, the lighting is natural, and the image is coherent and free of visual artifacts.diff --git a/skills/hypit/references/playbooks/craft/generated-dependencies.md b/skills/hypit/references/playbooks/craft/generated-dependencies.mdindex f884f636..39b5f704 100644--- a/skills/hypit/references/playbooks/craft/generated-dependencies.md+++ b/skills/hypit/references/playbooks/craft/generated-dependencies.md@@ -19,9 +19,9 @@ directly from it when that parent already supplies the difficult facts. Describewhat matters to preserve.The first image in a dramatic setting may contain one person or several. Within that setting,-complementary views can retain the shared atmosphere, light and spatial relationship while showing-the different background sector visible to each camera. Those useful views can support several Takes;-a modest change of performance or framing does not require another image edge.+complementary views can retain the shared atmosphere, palette, materials and spatial relationship+while showing the different background sector visible to each camera. Those useful views can support+several Takes; a modest change of performance or framing does not require another image edge.A meaningfully new setting can begin with an actual camera image in that world, connected to theauthoritative character, product or continuing prop references it needs. Each setting can branch fromdiff --git a/skills/hypit/references/playbooks/craft/image-direction.md b/skills/hypit/references/playbooks/craft/image-direction.mdindex a41f1b2a..58c82237 100644--- a/skills/hypit/references/playbooks/craft/image-direction.md+++ b/skills/hypit/references/playbooks/craft/image-direction.md@@ -1,72 +1,185 @@# Directing generated images-Read this when an image must establish a person, place, product, visual world, or useful camera view-for the production. Read `../../creation/transformations.md` when deciding what a supplied-identity or product changes across the work.--## Begin with the world the image must establish--Image generation and reference-conditioned video generation form one directing system. The image-creates a credible person, space, object, composition, and visual language; the video model lets that-world perform, move, and be photographed over time. Choose the audience's first impression as part-of that production purpose: who or what draws attention, what presence it has, and what encounter-the viewer feels invited into. For social-video presenters, actively direct an attractive, distinctive-presence suited to the work. Make the intended appeal as clear as the required framing, whether the-person is invented or supplied by the user.--Generate an image when the work needs to establish or change visible facts. Reuse an existing image-when it already supplies them; some shots can proceed directly to video generation.--For the social-native videos Hypit most often makes, a photographic frame with the texture of real-phone footage is a strong default. Presenter-led UGC, podcasts, street interviews, lifestyle B-roll,-product demonstrations, and many comic or fantastical subjects all benefit from beginning inside a-specific captured world. The Brief, Treatment, or reference work can instead call for illustration,-animation, designed graphics, studio product photography, archival imagery, or another visual form.--Treat photographic credibility as an ordinary production goal. The intended result belongs to the-same visible category as a plausible captured frame, rather than to a separate “AI-looking” category.-Judge the world the image creates. A person, animal, meme character, mermaid, or imagined location can-inhabit the photographic language of recorded footage when its materials, light, camera, and-surroundings behave as if they were physically present.--GPT Image 2 is the usual recommendation for this work. Favor `2K` for a picture that will appear-full-screen or establish a full-screen video shot. `1K` is often sufficient for a smaller inset or-graphic asset. Choose from its eventual visible size, cropping, detail, and cost; another resolution-or model can suit a particular image better.+Read this when creating a person, place, product, B-roll image, or camera view for a video.+An image establishes the world that a reference-conditioned video model can bring to life.++For the phone-shot social videos Hypit most often makes, the useful direction is compact and vivid:+strong character appeal, a recognizable cultural or social presence, a clothing vibe, a few telling+objects, and a clear color relationship. A short direction can be very specific; its force comes+from what it chooses.+Aim for the visible credibility of actual phone footage, including with invented people and+fantastical subjects. Judge the generated picture against that photographic goal.++## Compress the idea into decisive anchors++Think from the intended picture down to the choices that make it visible. What will this image do+in the video? What makes the person compelling, and what encounter are we looking at? Let that+whole-picture intention guide the casting, attitude, styling, setting, color and camera relationship.+The prompt expresses those decisions in the language of a picture.++Compression preserves the force of the idea. "As beautiful as a top Korean girl-group idol" carries+a strong casting direction; "sweet, slightly rebellious, casually sharing her take with a friend"+gives a speaking presence. Blunt bangs, a spiked cap and a goth T-shirt make that presence specific.+A metaphor or cultural reference is useful when it evokes visible qualities the model can develop.+Choose one that serves this person, then add the few details that distinguish this picture.++Give each anchor the scope it needs: goth can describe the girl's styling while a Korean café+supplies the setting. A few objects can establish the encounter and its colors together. Let the+model complete incidental detail from those choices. Keep precise facts that the work depends on:+recognizable identity, an exact product, HYPIT lettering, gaze toward a partner, or room for an icon.+"Beautiful composition" would leave an intended rightward placement unstated.++Judge the wording by how clearly it evokes the intended image. Preserve the full chosen capture+paragraph and strong attraction language; omit detail that adds no useful direction. Group related+choices so they are easy to revise. The [café example](examples/image-direction.md#goth-girl-outside-a-korean-cafe)+shows one compact arrangement; a derived view can say even less when its reference already supplies+the person and world.++For these phone-video portraits, four paragraphs give the direction a clear shape:++| Paragraph | Directing question | What to express |+| --- | --- | --- |+| Capture | What kind of photographed image is this? | The Kit's full fixed iPhone-video paragraph. |+| Encounter | How is this person relating to the viewer or another person? | Framing, centered or offset placement, standing or seated posture, a useful idle state, speaking or listening action, and a vivid social attitude, chosen for this scene. |+| Person | Why would the audience want to watch this particular person? | Explicitly strong attraction, cultural or social character, intended proportions, and a few distinctive hair, makeup and wardrobe choices. |+| Place | What actual place does this camera view belong to? | A recognizable setting, its visible construction, a few signs of use, and colors carried by its materials and objects. |++Think about these relationships together. The encounter determines gaze; the person's clothing+participates in the place's palette; a side table can explain the composition. Fluent paragraphs+carry those choices. The Kit assembles the encounter as `shot` and the person and place as+`direction`; reference responsibilities remain in its optional `references` text.++## Make the person immediately compelling++For an invented social-video presenter, actively cast someone the audience will want to watch.+State the strength and kind of attraction directly: exceptionally beautiful, stunningly handsome,+Korean girl-group idol beauty, a commanding mob wife, or a round orange cat with a boss's authority.+Heritage, subculture, profession, and attitude can quickly give that appeal a particular character.+Choose the ones that make this person come to mind.++For an attractive invented human presenter in this style, explicitly direct a small face,+**broad shoulders and excellent head-to-shoulder proportions**. These choices carry across seated,+standing, centered and offset views. Narrow, pinched shoulders under a large-looking head can make+the portrait feel doll-like. Preserve the physique of a supplied person or a deliberately different+character, developing the appeal of that person.++A few visible choices can carry the look: blunt bangs and long straight black hair, feline eye+makeup, a spiked cap, and a goth T-shirt. Describe the clothing vibe and its memorable details.+Exceptional beauty and strong styling fit naturally inside real phone footage.++Keep the language forceful when revising. "As beautiful as a top Korean girl-group idol" directs+appearance; "idol-level polish" directs grooming. Preserve the intended beauty, attitude and cultural+meaning when carrying a successful direction into a new prompt.++Vibe is useful when it brings a person or scene immediately to mind: "Stay out of my husband's+business," "a cat with born-to-be-the-boss authority," or "she recognizes a record from its first+two seconds." Write that feeling into the image. Production reasoning belongs in the Treatment;+the prompt gives the model a person, an action, and a world it can picture.++## Establish the place with a few details++Give the camera a view into a recognizable, constructed place. A wooden café shopfront with a+recessed entrance and tables along the pavement implies surfaces, depth and a way the place is used.+In a record shop, shelves turning into an aisle and a nearby browsing bin can do the same work.+Choose the few features that make this particular view come to mind.++Surface texture and spatial structure contribute different things. Grain or plaster texture can+give a surface variation while the whole background still reads as one flat plane. A door recess,+window bay, shelving return or relationship between furniture and the room can establish how that+space continues. Describe the useful feature directly. A broad wall can belong naturally to this+view, with its material, edges and relationship to the surrounding architecture.++The setting can support, contrast with, or simply coexist with the person's style. A striking goth+girl can sit in an ordinary classroom. A glamorous woman can sit in a restaurant. Ordinary places+often make a distinctive person more striking. Choose surroundings that suit the intended encounter;+styling alone does not determine a person's profession, room, or lifestyle.++A useful detail can do several jobs: a table on the left balances a person on the right and gives+the scene a nearby surface; a half-eaten dessert suggests a visit already underway and carries a+color accent; an undersized cat tree makes a cat CEO funny.++## Give the frame a clear color relationship++Consider the person and background together: skin, hair, clothing, furniture, and the surfaces around+them. Choose which colors occupy the larger areas, which support them, and which appear as small+accents. Give those colors real places in the image. Coral plaster walls, an oak desk, a group of blue+posters, and a small green plant describe both a palette and a room.++Consider the relative areas of color, the variety in detail, and where attention goes in the whole+image. A wooden shopfront, a red awning and leafy plants give colors both a role and a physical form.+Larger, quieter surfaces can sit beside smaller areas of detail. Color contrast and material changes+can give the person prominence. Express that balance through the chosen clothing, construction and+objects.++Name hues without adding brightness instructions to them. Purple, coral red, blue, and green already+give direction; casual additions such as "bright," "deep," "dark," or "light" can change the overall+image when only a hue was intended. The Kit supplies the natural-lighting premise. Add a particular+time, weather condition, or light event when the intended scene actually needs it.++For this photographic style, prefer colored, textured materials over broad white or flat gray areas:+colored plaster, wood, fabric, and foliage can supply surface variation and a more deliberate palette.+Choose what complements the subject. A texture adjective alone does little for a weak color pairing.+Cream clothing against an extensive white background once washed the person into the setting; navy+clothing gave her definition. Treat wardrobe and surroundings as a combination.++When exact white, gray, or black belongs to a product, uniform, or chosen outfit, preserve that fact+and let the surrounding colors and materials support it. A concise material cue can give a large+surface variation. Ordinary surfaces can otherwise keep their naturally rendered detail.++## Frame the image for what it will become++Choose placement, stance and framing from what this scene needs to show. A centered person can+address the viewer directly; an offset person can share the picture with a product, a partner or MG.+Standing or sitting describes posture. A standing presenter can still have a close half-body view,+and a seated person can appear in a wider composition. Choose each relationship deliberately.++For a face-led speaking image, a close half-body view is a useful starting point: make the face and+gestures easy to read while retaining the shoulders and upper body. Keep a comfortable camera+distance and natural-looking proportions. Use a wider view when the work needs an outfit, a bodily+action or more of the surrounding encounter. Describe the intended visible area of the body so the+crop supports that purpose.++Off-center placement can feel natural through the scene itself: put a desk to the person's left,+or let their thighs angle toward it. Seat and leg details can help establish posture without asking+for a wider full-body view. Keep the intended visible body within the frame.++Compose for the later video. A Ranking icon on the left may call for a person on the right, with+their face near the upper right. Describe that placement and the actual room in the image prompt.+Author the later icon or MG in its own component. Faces, hands, microphones, and products need room+to remain readable when those layers appear. [Compositing](compositing.md) owns the layer relationship.++## Choose an idle state for the encounter++For a camera image reused across speaking Takes, idle means a comfortable, readable state from which+the person can keep performing different passages. Give them a recognizable attitude, an engaged+speaking or listening presence, and a natural relationship to their microphone or prop. "Holding a+handheld microphone and speaking, with the free hand gesturing naturally" already brings the image+to life. Save a particular punchline reaction for the passage that earns it.++Choose face and body direction from whom the person is addressing:++| Intended camera relationship | Useful reusable image direction |+| --- | --- |+| Speaking directly to the viewer | Face the lens straight ahead, with no head tilt or rotation. This keeps the face readable and gives later passages a settled frontal view to grow from. |+| Talking with a podcast partner | Turn and look toward the partner, keeping the face usefully visible from this camera. Complementary views preserve the pair's screen positions, gaze and microphone relationship. |+| Interviewer and guest attending to each other | Preserve their shared spatial relationship in the two-person view and its close views. Each person's attention follows the exchange. |++The intended relationship decides the pose, including when a format contains more than one kind of+shot. Idle leaves room for expression and motion in the generated performance. An image meant to+establish a particular laugh, glance down or other story moment can show that moment directly.+For reusable views, direct opening and closing actions in the relevant video passage: a guest can+look down before noticing the interviewer, then turn toward them. A character-and-scene reference+supplies visual facts; the selected generation mode determines whether it is a literal first frame.+See [video direction](video-direction.md) and the+[conversation images](examples/conversation-images.md) for those relationships.## Use a concrete capture direction-For social-native photographic work, direct the model toward a recognizable capture process rather-than asking abstractly for “photorealism” or “high quality.” The phone-video capture direction-describes the result as one frame cut from video actually shot on an iPhone: real without an oily,-overprocessed finish, carrying video texture, with readable background,-fine skin and material texture, natural-looking lighting, and an intact image.--Actual GPT Image 2 generations show that the complete wording repeatedly moves results toward the-visible character of ordinary phone-video frames. Preserve it as tested model-specific direction,-without turning an inference about the model's learned visual associations into a claim about its-undisclosed training data. Another model or visual form calls for evidence from its own results.--The direction combines a familiar social-video camera language, believable surfaces, and enough-background information to establish a real place that can continue into a moving shot. Choose the-subject's styling and the way the camera records it separately: a glamorous, carefully dressed person-can appear in casually recorded phone footage. Extraordinary beauty or fantastical subject matter-can still inhabit this captured visual world.--The capture language describes how the picture looks, not a prop that must appear in it. Add a-specific material or lighting direction when the shot needs that fact.--When the model exposes aspect ratio, resolution, or output dimensions as request parameters, treat-those parameters as their authority. Numeric ratios and resolution labels usually need no repetition-in the descriptive prompt. Keep directional camera or orientation language when it materially clarifies-composition, then spend the remaining attention on the actual shot: camera distance, subject placement,-what remains visible, and how the subject relates to the setting. The model package owns the exact-parameter names and supported values.--For this capture language, import `@hypit/gpt-image-kits/phone-ugc-v1`. Its fixed-English capture paragraph preserves the production method, while `shot` and `direction` carry the-current image and optional `references` text explains the connected media. The Source export enters-the production's Source Closure directly:+For this photographic style, use the full iPhone-video capture paragraph from+`@hypit/gpt-image-kits/phone-ugc-v1`. It describes a frame from video actually shot on an iPhone,+with natural lighting, fine skin texture, and a clearly readable background. This wording comes+from successful production use with GPT Image 2. Keep it intact when selecting this Kit; put the+current picture's framing in `shot` and its character, setting, colors, and vibe in `direction`.```svml<import as="text" from="@hypit/text@1"/>@@ -79,308 +192,50 @@ the production's Source Closure directly:</text:Render>```-`shot` and `direction` are required; omit the `references` Set when no media reference is connected.-The resulting `{portrait-prompt}` is ordinary Text. Pass it to the selected image Surface and connect-the actual reference images there as explicit graph inputs; explaining a reference in Text does not-create that media edge.--[Image direction examples](examples/image-direction.md) pairs the record-store portrait with its-English production prompt and observations of the result, alongside three supplied case images with-faithful English translations of their production prompts. Use these when the capture language,-aesthetic specificity, or relationship between character and scene choices is unfamiliar. Each case-identifies what its evidence covers.--Within one production, use a prompt language the selected model handles well and keep reusable capture-wording consistent.-Preserve aesthetic force, social meaning and specific facts when translating: confident praise, a-familiar cultural type and a vivid attitude retain their full strength. Keep dialogue, visible text,-names and other literal wording in the language the work requires.--## Direct a person from identity and presence--Begin with the kind of person the audience should recognize, the role they play, and the presence-they bring to camera. A social archetype, subculture, profession, attitude, or compact piece of-character language can coordinate face, styling, posture, environment, and props more effectively-than an inventory of facial measurements.--When on-camera attraction, charisma, beauty, handsomeness, strength, cuteness, awkwardness, age, or-comic authority matters, state it directly and with conviction. A direction such as “exceptionally-beautiful, with the presence of a top Korean girl-group idol,” “the striking beauty and commanding-presence of a leading Italian film actress,”-or “a round orange cat with effortless CEO authority” gives the model an overall aesthetic target.-Support it with a few visible anchors that distinguish this character. Let millimeter-level anatomy-remain subordinate to the intended person and the camera image.--Photographic credibility can coexist with exceptional beauty, precise makeup, excellent skin and-strong styling. Preserve the requested appeal; natural texture describes how the captured surface-reads, while the person remains as polished, attractive or distinctive as the direction requires.--For the attractive, invented presenters in this photographic style, explicitly direct **broad-shoulders and excellent head-to-shoulder proportions**. Overly narrow, pinched shoulders beneath a-disproportionately large head can make a generated half-body portrait feel flimsy or doll-like even-when the face is convincing. This is a useful whole-figure direction, alongside strong beauty or-handsomeness, rather than a request for anatomical measurements. Preserve the actual physique of a-supplied person and any different body type intentionally chosen for the character.--Express the intended appeal in the character's own terms:--- For an appealing older character, state distinguished beauty or handsomeness, vitality, and the- presence of someone who was strikingly good-looking in youth. Age remains part of the person.-- For an animal, choose the imposing, cute, or comic presence the role needs. A lustrous coat and- handsome proportions can serve a majestic animal; the orange-cat CEO's round face, large belly,- straining suit, and undersized cat tree give its authority a comic form.-- For a recognizable Meme character, preserve its defining features, silhouette, and proportions.- Express appeal within that character's visual identity while giving it the requested capture language.--Use wardrobe, grooming, jewelry, makeup, silhouette, and memorable details to reinforce-the same identity. They should belong to one person rather than read as unrelated fashionable items.-A beauty comparison can establish the strength of the appeal and another phrase its particular-character; a role-specific disposition makes that person socially present. In the-[record-store example](examples/image-direction.md#shanghai-record-store-owner-one-coherent-person),-idol-level beauty, an independent film actress's cool presence, and effortless musical expertise-describe compatible qualities of one woman. The bob, knitted polo, headphones, and shop then give-that casting idea visible form. The transferable choice is this coherence: another person may need-different beauty language, styling, and surroundings, without acquiring a fixed number of comparisons-or a required idol-and-actress formula.--When the user supplies the person, pet, product, or character they want, look at the image and use it-as the identity reference. "Use the person in reference image 1 as the presenter" can be enough to-establish that relationship. The full capture direction, attraction, framing, proportions, setting,-and palette still do their work. Keep the aesthetic direction confident and specific to this subject.--Notice what can make this person compelling in the intended shot: their hair, styling, silhouette,-or expression may suggest a particular presence. Develop that appeal through the image's wardrobe,-light, color, and vibe, keeping the supplied identity recognizable. Choose which of the photo's-other details belong in the new scene. The [supplied-presenter variation](examples/image-direction.md#the-record-store-shot-with-a-supplied-presenter)-shows how much of a complete prompt can carry forward with that change.--## Let the setting belong to the subject--A useful camera image normally creates the person and their setting together. The setting is not an-empty plate waiting for a subject to be inserted. It reveals who this person is, what they are doing,-and what kind of video the audience believes they are watching.--Choose a small number of details that carry that relationship: condensation on an iced latte in a-Korean-style café, a product diagram on a startup whiteboard, a cat tree that is visibly too small for-an orange-cat CEO, drying flowers on a textured wall, or worn candles inside a real stone chapel.-Favor details that connect choices across the image. The record-store owner's turntable belongs to-her work and gives the composition a physical counterweight; a handwritten recommendation card-expresses how she runs the shop. Make the details that define this person, place, and shot explicit,-then leave incidental particulars open for the model to resolve within that direction.--Give the scene a relationship to its viewer when that relationship matters: the owner is taking a-moment to recommend an album to you. A compact line like this conveys ease, expertise, and personal-attention without prescribing a smile or a precise gesture. After describing the visible details,-a closing vibe sentence can bring the whole image back to the intended encounter or atmosphere,-rather than repeating a list of props or adding unrelated style adjectives.--Describe the setting from the camera view that will actually be used. Another useful angle can grow-from that image while showing the naturally different part of the same place. The work needs camera-images that do a real job. An independent location image is useful when the work needs that location-on its own; otherwise the actual camera view can establish both the person and the place.--Across related views, distinguish the shared world from what this camera sees. The shared world can-carry a warm dessert-shop atmosphere, natural afternoon light, textured materials and the social-relationship between two hosts. One view may see the window and table while the reverse view sees the-counter and another group of ordinary objects. The background then feels continuous without becoming-a copied backdrop. In a short drama, the same judgment lets a location carry character, mood and plot-while each useful camera image remains authored for its own view.--Write fluent natural-language direction, with exact props and relationships singular and clear.-Separate mutually exclusive visual states into the images the work needs. Preserve dominant facts-across related images, including the chosen capture language on derived views: an identity reference-and a capture direction do different jobs.--## Frame the image for what it will become--A camera image can establish identity, space, composition, and capture language together. A portrait-used only for identity or a product reference used only for geometry does not also dictate camera-position, pose, or setting. State which facts the downstream shot should inherit. A reference is not-necessarily its literal first frame; exact endpoint control is a separate shot decision.--For recurring presenter images, favor a sustainable presence: relaxed confidence, attentive curiosity,-or effortless authority. This is the useful idle principle. Give the video room to perform the line,-gesture, or emotional change instead of fixing the person in a blink, peak grimace, or contorted pose.-Describe a disposition, such as warmth or a compelling gaze, instead of choreographing a raised-eyebrow, narrowed eyes, a grin, a head tilt, or a precise hand gesture. For these reusable speaking-images, “speaking to the camera, with the free hand gesturing naturally” gives enough direction.-Idle retains the character's emotional presence while leaving the later performance room to change.--For a presenter image, that may be a clear face, readable upper body, handheld microphone, natural-gaze, and a posture with room for gesture. For a podcast reverse view, eye line and microphone entry-matter more than front-facing symmetry. A selfie needs a physically credible phone-camera-relationship. A product-use image needs the hands, product, and contact geometry that the action will-continue from. B-roll may begin with a more specific action because the visual event itself carries-the passage.--For a reusable presenter image, a half-body view can place the person modestly near the camera, with-the face level and directed straight ahead, a handheld microphone, and clear shoulders and arms.-Direct distance and proportions together: “She sits slightly nearer the camera in a comfortable-half-body composition, with broad shoulders and excellent head-to-shoulder proportions.” The face-should be readable while the shoulders and upper body still establish the person. Repeatedly-intensifying “close” can instead favor a face-dominated crop. Asking to keep the body in frame means-preserving the intended visible silhouette, not widening the shot until the whole body fits.--Choose left, center, or right placement from the intended camera view and eventual composition.-Off-center placement can be a direct camera decision; it needs no added prop to explain it. When a-table, chair, partner or product truly belongs in the generated scene, its geometry can also motivate-the person's posture, gaze or contact and contribute balance inside the frame. Choose those objects-for the physical scene's own story, while camera composition reserves room needed by the editorial-layout. Describe the person and setting as one actual camera image.--Give gaze, posture, touch, and other interaction only to people or objects that actually belong in-the generated image. A later Caption, icon, product card, or other MG can influence framing and the-subject's placement, but it is not an object in the character's physical world. Keep the person-engaged with the camera or with the real scene, and direct the generated setting as the complete,-natural place it should be on its own.--Use seat and leg details when they explain that relationship. A brief direction such as “her thighs-angle toward the table on her left” can be useful; a catalog of shoes or clothing outside the intended-crop can compete with the framing. A foreground table, visible feet or lower-body detail belongs when-it serves the scene and leaves the face, microphone and important gesture area readable.--Apply that speaking-reference solution when the work has the same need. A side-on conversation,-product action, or full-body shot needs its own gaze, hand occupancy, contact, and composition.-A specific starting action is useful when the shot is actually about that action.--Compose for the final stack. A Ranking icon planned for the left can call for a presenter toward the-right while the presenter continues speaking to the camera or acting inside the real scene. The same-person may remain on that side across every related shot. Keep the face, microphone, and useful-gesture area clear of the overlay's actual footprint and movement. The rest of the source image still-belongs to its real setting. Position and scale follow this work's visual hierarchy. [Compositing](compositing.md)-distinguishes the generated scene, camera composition and later editorial layers.--Translate that layout into visible image direction: describe subject placement, camera framing, and-the real setting. Author the MG separately in its component. The image prompt describes the pixels-this request should produce; downstream editorial content stays in the downstream composition. Carry-the intended placement into the generated performance without inventing an interaction with that-later layer. Frame the face at a height compatible with a face-following Caption. If a board covers-the lower frame, place the performer in the region that remains visible. If a product or screen is-part of the generated scene and must be read, give it enough scale and a credible relationship to the-person.--## Make imagined subjects physically present--Fictional content does not imply an illustrated or computer-generated finish. Place the extraordinary-subject inside an ordinary physical camera world. The mermaid prompt establishes wet hair, shells,-real pearls, coral, fish, light entering the water, and shells scattered on the sandy seabed. These-specific states and surroundings make the intended world concrete.--Describe the fantastical facts positively and give the physical directions the scene needs. Familiar-material names and a few decisive states can be sufficient; explicit grain, reflection, wear, and-contact instructions belong where they resolve an actual ambiguity or serve the shot. The result can-remain strange, funny, or impossible while feeling as though somebody pointed a phone at it.--For this photographic fantasy method, finish by reaffirming the subject's physical presence in the-specific place: “The image looks real, as though this woman is actually sitting underwater.” This-repeats the intended reading of the whole image after its fantastical details.--## Direct color through material and atmosphere--Compose the palette across the whole frame. Consider the visible area and relative lightness of-skin, hair, clothing, furniture, and background together. Decide where the person should separate-from the setting, which colors belong together, and where the eye should settle. Material texture-alone cannot give a poorly coordinated palette a clear subject or believable tonal depth.--In one portrait, a cream knit against a white background made the image feel too bright and washed-out; navy clothing gave the person definition against the light surroundings. This is a relationship-between wardrobe and setting, not a rule against cream or white. For an intentionally pale, luminous-image, direct the tonal separation, skin color,-surface variation, and lighting that keep it convincing. When exact wardrobe or brand colors are-fixed, make the adjustable surroundings work with them.--For these character portraits, two anchor colors can establish a compact palette that supports the-overall atmosphere. Let incidental colors belong to that whole; this does not require every object-to use exactly one of two colors.--Then name useful hues and materials. Coral fabric, charcoal wood paneling, weathered brass, or cream-plaster carries color together with physical response. A few relevant material cues support the-overall direction; every surface does not need its own grain, seam, defect, or texture instruction.--In palette descriptions, name hues without casually adding brightness modifiers such as “bright,”-“dark,” “deep,” or “light.” These words can steer the whole image's lighting when only a color was-intended. Describe the wanted lighting separately.--For white or black areas whose exact color is not essential, prefer a light- or dark-toned material-with visible surface variation. This is a deliberate alternative to an extreme black/white field,-not a reason to attach brightness modifiers to every hue. When exact black or white is required,-keep it and use a concise material or texture cue to give the area visible variation.--| Palette shorthand to improve | A material-led direction |-| --- | --- |-| deep purple and pure black | purple fabric and charcoal wood panels |-| cream clothing against an extensive white background, when it washes out the intended image | give the subject definition through wardrobe and background together, such as a navy knit against light plaster |-| a pure white wall | light-toned textured plaster |-| a required black jacket | black leather with visible grain |--These examples teach authored choices, not automatic word substitutions. Exact product, wardrobe,-makeup, and brand facts remain exact. Preserve the actual wording when documenting an existing result;-apply the current palette judgment when directing a new image. Surface detail supports the image;-avoid turning the correction into an inventory of defects or a demand for roughness.--When an image feels washed out or its color balance feels wrong, identify what is visible: large pale-areas merging, missing highlight detail, flattened skin color, or a color cast. These observations-point to different adjustments; an overly pale palette alone does not establish a white-balance-fault. Keep wardrobe and set design, exposure and lighting, and color balance distinct in the-diagnosis, then make them serve the same image.--Light belongs to the same physical description. State the source and broad relationship that matter:-soft window light from camera left, ordinary overhead office light, overcast street light, or warm-lamps within the room. Let texture and small irregularities survive. The goal is not to make every-image dark, flat, or underproduced; it is to make polish arise from a believable captured world.--“The lighting is natural” means the light belongs convincingly to the scene. It can come from-daylight, room fixtures, or the practical lights of a night location. Give the face the exposure it-needs while letting the setting retain its own readable detail, shadows, materials, and tonal depth.-Choose wardrobe, surroundings, and light as one relationship so a polished, beautiful subject still-feels physically present in that place.--## Give references clear responsibilities--Use references when the image needs a fact that public visual knowledge or prose cannot reliably own,-or when exactness itself matters: the user's identity, a private or obscure product, a particular-current logo, proprietary UI, or a camera image already used by the work. A familiar public icon,-person, meme, object or place can be generated directly when recognizable visual meaning is enough.-State what each reference contributes and what the new image may change. Choose it because it owns a-needed fact, not merely because it was generated most recently. A new view can inherit the same room-while showing a different arrangement of its objects in the frame.--Keep the relationship shallow and useful. The first actual A-roll camera image often establishes the-person, setting, camera culture, and art direction together. Another A-roll view can use it to retain-the person and world while changing eye line and camera position. A B-roll image can share the person-or product when continuity matters. One useful image can constrain several later images and Takes.--The Source owns the exact Resource edges. The Treatment explains why this work preserves or changes-the relationship. Model documentation owns reference count, media support, aspect, resolution, and-other request limits.--[Conversation image examples](examples/conversation-images.md) show this distinction in complete-podcast and interview directions: a complementary host view, product-holding variations, independent-lifestyle scenes and two close views derived from one shared encounter. Use-[Reference relationships](generated-dependencies.md) when deciding which parent each image needs.--## Judge visible causes, not provenance--Look at the generated image as the intended audience will see it and as the downstream video model-will use it. Consider whether the intended appeal and personality actually come through, whether-the subject draws attention within the whole frame, and whether the image supports the next shot.-Name the visible cause of a weak result:--| Visible result | Revisit |-| --- | --- |-| an interchangeable polished face | the character's role, presence, and aesthetic direction |-| an oversized-looking head above pinched shoulders | shoulder breadth, head-to-shoulder proportions, and the camera framing |-| a beauty campaign instead of social footage | the capture direction, light, texture, and camera relationship |-| an empty showroom or decorative collage | the few setting details that reveal the subject's world |-| flat dark or light regions | material, surface variation, palette, and local lighting |-| a pale subject merging into a pale setting, or an overall washed-out image | the relative lightness and visible area of clothing and background, skin color, and exposure |-| implausible hands, gaze, microphone, phone, or product contact | the physical relationship and framing |-| identity, product, or room drift across useful views | the selected reference and its stated responsibility |-| a strong still that cannot support the intended motion or overlays | the shot's downstream role and performable state |--Authorized image outputs continue downstream through the relationships declared in Source. When-looking at an existing image or Result, use this table to diagnose the visible problem. If a result-cannot serve the user's goal, identify the owning direction or reference decision. Additional paid-generation is an explicit production decision under `../../production/authoring.md` and the user's-spending authority. Build quality into the direction and reuse produced media during deterministic-refinement.+`shot` and `direction` are required. Omit the optional `references` Set when no reference is used.+The slots assemble ordinary prompt text. Group related choices into short paragraphs: the café+example gathers framing and action in `shot`, then casting and styling, followed by setting and+color, in `direction`. This keeps each relationship easy to see and revise. Pass the resulting+`{portrait-prompt}` to the image Surface and connect any actual reference images there.++GPT Image 2 is the usual choice. Favor `2K` for a full-screen picture or video reference; `1K` often+suffices for an inset or small graphic. Set aspect ratio and resolution on the model's parameters.+The prompt can concentrate on composition inside that shape. Illustration, animation, product+photography, and other visual forms can use the capture language appropriate to their own goal.++A fantastical subject can still look physically present in this photographed world. For a mermaid,+wet hair, shells, a coral reef, and a few fish can establish the scene. "She looks as though she is+really sitting underwater" reaffirms the intended feeling. The [complete examples](examples/image-direction.md)+show the capture paragraph with the goth café, record shop, mob wife, cat CEO, and mermaid.++## Let references supply the facts they own++Look at a supplied face or character before writing. "Use the person in reference image 1" establishes+identity; direct their attraction, clothing, setting, colors, and camera view with the same care as an+invented subject. Develop the features and presence that make this particular person compelling while+keeping them recognizable. Their identity comes from the reference and the user's description.++A product reference can supply the exact product; a parent camera image can supply a person and room.+Explain what carries forward and what changes. Another view of the same place may show different+objects because the camera faces a different direction. Preserve the capture language on that view.+An image used for identity does not automatically fix the next video's literal first frame.++Choose references for the facts the work needs: a user's face, an exact product, a logo, a particular+room or a continuing character. Keep the dependency tree shallow where one parent already supplies+the needed facts. Familiar things can be described directly when recognizable meaning is enough.+Connect reference images as real model inputs; prose alone does not create those edges.+[Reference relationships](generated-dependencies.md) and [conversation examples](examples/conversation-images.md)+cover multi-view work. [Transformations](../../creation/transformations.md) covers what a face or product+swap changes across the video.++## Judge the picture by its intended appeal++Look first at whether this is the person and feeling the work needs. Then check framing, proportions,+color relationships, and the visible interactions the video will depend on. Read the background as+a place: does its construction and use come through, and does the person feel situated in it? When+a view feels like a flat backdrop, reconsider the view and its spatial anchors before adding surface+adjectives or more props. A well-described room+does not compensate for weak casting. When revising, change the choice responsible for the weak+result; retain the choices that already work. Keep produced images that remain useful to the work+with their exact prompts and model settings so the next direction begins from actual production+evidence.diff --git a/skills/hypit/references/playbooks/craft/seedance-directing.md b/skills/hypit/references/playbooks/craft/seedance-directing.mddeleted file mode 100644index 7e99bbfd..00000000--- a/skills/hypit/references/playbooks/craft/seedance-directing.md+++ /dev/null@@ -1,145 +0,0 @@-# Directing generated performance--Read this when turning useful visual references and Script into living speech, interaction or-silent action. The image establishes who and where; motion makes something happen to them.--Seedance 2 Mini at `720p` is the usual recommendation for capable, affordable generated performance.-Choose another model or resolution when the work's visual or performance needs call for it.--## Give each input its own responsibility--| Input | Responsibility |-| --- | --- |-| Character-and-scene references | appearance, setting, framing and the physical state to preserve |-| Recurring voice references | the intended speaker's voice identity |-| Script dialogue projection | the exact words and speaking turns |-| Kit Recipe | recurring camera, edit, pace and performance choices |-| Action direction | this passage's attitude, attention, physical interaction and motivated cuts |--Seedance exposes three distinct request shapes:--| Surface | Inputs and use |-| --- | --- |-| `seedance:TextVideo` | Text alone; useful when the intended world does not need visual identity or composition references. |-| `seedance:FrameVideo` | A required first frame and optional last frame for literal endpoint control. |-| `seedance:ReferenceVideo` | One or more image, video, or audio references that guide identity, world, voice, motion, or camera language without declaring literal endpoints. |--Most controlled Hypit production starts from useful generated images and uses reference generation.-That reflects the work's need for identity, scene, composition, and repeatable visual relationships;-it does not remove the other request shapes when their meaning fits. A last frame belongs only when-the shot genuinely needs to arrive at that exact image.--Kits produce ordinary Text; the Source connects that Text and explicit references to the selected-request shape. Action does not secretly add references. The reusable package Sources are:--| Import | Intended prompt relationship |-| --- | --- |-| `@hypit/seedance-kits/speaker` | One visible speaker, one character-and-scene image, and one voice reference. |-| `@hypit/seedance-kits/broll` | A silent visual event or montage. |-| `@hypit/seedance-kits/podcast` | Two conversation views and their two voices. |-| `@hypit/seedance-kits/call` | Two video-call reverse views. |-| `@hypit/seedance-kits/street-interview` | Interviewer, guest, shared view, and two voices. |-| `@hypit/seedance-kits/motion-reference` | Preserve the subject while transferring body motion. |-| `@hypit/seedance-kits/camera-reference` | Preserve the subject while transferring camera language. |--A speaking Take can be assembled directly from the installed Source:--```svml-<import as="text" from="@hypit/text@1"/>-<import as="seedance" from="@hypit/seedance@1"/>-<import as="speaker-kit" source="@hypit/seedance-kits/speaker"/>--<text:Render id="hook-prompt" template={speaker-kit.speaker-v1}- recipe={look.speaker.host}>- <text:Set name="dialogue" text={story.segment.hook.dialogue}/>- <text:Set name="action" text={hook-action}/>-</text:Render>--<seedance:ReferenceVideo id="hook-take" model="mini" prompt={hook-prompt}- duration="8" resolution="720p" aspect-ratio="9:16" generate-audio="true">- <seedance:Reference image={presenter}/>- <seedance:Reference audio={voice}/>-</seedance:ReferenceVideo>-```--The selected model vocabulary supplies its current duration, reference-count, format, and media-limits. The Kit does not own those limits or the request's explicit media edges.--For this visible A-roll form, the ReferenceVideo request is the speaking performance: it receives-the short Voice Reference and exact Script dialogue, then returns the person's performed picture and-sound together. Voice Design establishes who that person sounds like, so its short casting line can-be unrelated to the finished dialogue. Voice Clone instead produces audio-only A-roll when a passage-has no on-camera speaking performance.--Use the Script's `.dialogue` Text rather than retyping dialogue into action. Map Role names to the-Kit's A/B identities where necessary. Preserve one recurring voice reference per character when-voice continuity matters. See [Voice and performance](voice-and-performance.md) for A-roll versus-genuinely independent narration.--## Direct the reason for a gesture--Start with the social situation and attitude: affectionate ridicule, candid surprise, dry confidence,-playful skepticism. Then choose a few visible actions that communicate it. A restrained lean, an-open-palmed explanation, a knowing shrug or a short glance can carry more than elaborate choreography.-Vibe alone may leave an important interaction unspecified; describe the decisive action when the-story needs a handoff, a look toward a partner or an exit.--The action prompt describes what this generation should make visible over time. Give the performer-physical relationships only with the camera, people, props, and parts of the setting that actually-exist in the generated scene. A Caption, icon, product card, or other MG that will be composed later-can shape where the performer is framed, but it is not something for the performer to point toward,-touch, watch, or reveal inside this Take.--Capable video models can turn figurative wording into literal objects, events, or transformations.-Use concrete visible language for the intended gaze, gesture, movement, camera behavior, and cuts-when a metaphor would introduce the wrong scene content. Social attitude and aesthetic shorthand-remain useful when they direct the performance; an imagined object or event belongs in the prompt-only when it should truly appear in the generated video.--Natural emphatic gestures are usually more reliable than asking fingers to display an exact number.-Let speech, Caption or MG convey the quantity while pointing and hand actions serve the performance.--Silence still has behavior. A listener can settle in the chair, notice the object, glance down and-look back up, breathe or smile while keeping their mouth out of the speaking performance. Pick small-actions that follow the exchange.--An encounter also has edges. Someone being interrupted can first be busy; someone finishing can-begin to leave. Those small causes make the clip feel like a piece of life rather than a pose that-starts and stops at the encoder's boundaries.--## Choose cuts as part of the performance--UGC can benefit from pause-trim jump cuts. A podcast can cut with the speaker or toward a meaningful-reaction. A street interview can favor the guest and use the interviewer close view for surprise.-Stable camera framing, expressive acting and frequent edits are compatible choices.--One Take can contain multiple shots, several speaking turns or a split-screen composition. One-Segment is not one speaker turn or one camera shot. Conversely, several UGC Takes can use the same-character-and-scene image and meet at natural editorial cuts. A genuinely continuous shot calls for-the model mode and direction that preserve that action. See [Reference relationships](generated-dependencies.md).--The Speaker Kit's `pause-trim-jump-cuts` requests an edited rhythm from the model. It does not inspect-or trim the returned media. If a produced pause actually needs editing, use an explicit media-operation and align the resulting edited media; a prompt choice is not a deterministic postprocess.--## Size the request around the delivery--Use `hypit measure` on the target Segment at its intended pace, accounting for interaction and pauses.-[Script and time](../../creation/script-and-time.md#measure-before-choosing-durations) explains the-command, rounding, and how estimates inform the writing. The original video's seconds help explain-its rhythm; the target's delivery determines how much generated media this passage needs.--Read the selected model's supported whole-second duration values with-`hypit vocabulary @hypit/seedance`. They constrain one generation request; the finished work and its-individual edited beats can have other lengths.--An estimate outside that range is a useful creative question. A brief question and its answer might-share one Take; a line might gain a few useful words or a natural reaction; a long exchange might-divide where the thought turns. Find the shape that serves the passage, then choose a supported-integer duration for the intended performance. After production, actual normalized media and-alignment supply its timing and word anchors.--Watch the result for the decisions that matter: engaged performance, correct speaking identity,-legible interaction, intentional cuts and the right degree of energy. Correct words alone do not-establish that the scene works. Continue the authorized production and revise a visible problem at-its owner.diff --git a/skills/hypit/references/playbooks/craft/video-direction.md b/skills/hypit/references/playbooks/craft/video-direction.mdnew file mode 100644index 00000000..ae457f07--- /dev/null+++ b/skills/hypit/references/playbooks/craft/video-direction.md@@ -0,0 +1,117 @@+# Directing generated video++Read this when turning useful visual references, voice identity, Script or a visual idea into living+speech, interaction, camera behavior or silent action. An image can establish who and where; generated+video decides what visibly and audibly happens over time.++## Give each input its own responsibility++| Input | Responsibility |+| --- | --- |+| Character-and-scene references | appearance, setting, framing and the physical state to preserve |+| Product, interface or other factual references | the visible facts that need continuity or exactness |+| Recurring voice references | a speaker's intended voice identity when the model accepts them |+| Script dialogue | the exact words and speaking turns for a visible performance |+| Prompt Kit or Recipe | a reusable prompt relationship that fits this kind of work |+| Passage direction | attitude, attention, physical interaction, camera behavior and motivated cuts |++Keep those responsibilities explicit in Source. Prompt prose does not create a media edge, and a+reference does not explain which fact it should preserve. A selected model may accept only some of+these inputs; use its installed vocabulary and package-local documentation for the exact request.++For a visible A-roll performance, the generated video normally carries the person's picture, exact+Script delivery and sound together. Give the request the useful camera image, the recurring Voice+Reference when supported, and the Segment's dialogue. Voice Design establishes who the person sounds+like; its short casting line does not need to repeat the finished Script. Independent speech is a+different A-roll construction, described in [Voice and performance](voice-and-performance.md).++For silent B-roll, direct the visual event and omit speaking identity that the shot does not use. A+listener or reaction shot can remain silent while still breathing, noticing, adjusting posture or+responding through expression. [B-roll](b-roll.md) owns its editorial relationship to the underlying+performance.++## Choose the generation relationship++Generated-video models commonly expose some combination of three relationships:++| Relationship | When it fits |+| --- | --- |+| Text-directed video | The intended world and action do not depend on an existing visual identity, composition or motion reference. |+| First-/last-frame video | The shot must begin or end at a particular authored image. |+| Reference-directed video | Images, video or audio should guide identity, world, voice, motion or camera language without declaring literal endpoints. |++Reference-directed generation is the strong starting point for controlled Hypit production because+useful images can already establish people, scenes, products, composition and visual continuity. The+requested performance then makes that world move. Text-directed or first-/last-frame generation remains+useful when its relationship is genuinely the one the shot needs; a last frame belongs when arriving+at that exact image is part of the intended action.++Model-specific Surfaces and Prompt Kits are implementations of these relationships, not the Craft+itself. Kits produce ordinary Text; Source connects that Text and the actual references to the selected+model request. The current Distribution may provide model-specific Kit packages such as+`@hypit/seedance-kits`; their package documentation owns exact imports, slots, Recipe choices and+reference order. [Prompt Kits](../../production/prompt-kits.md) explains using or authoring a Kit+without making it a model wrapper.++## Direct the reason for an action++Start with the social situation and attitude: affectionate ridicule, candid surprise, dry confidence,+playful skepticism, quiet concentration or another relationship the audience can recognize. Then+choose a few visible actions that communicate it. A restrained lean, open-palmed explanation, knowing+shrug or short glance can carry more than elaborate choreography. Vibe establishes the performance;+describe the decisive physical action when the story needs a handoff, reaction, entrance or exit.++The prompt describes what this generation should make visible over time. Give a performer physical+relationships with the camera, people, props and parts of the setting that actually exist in the+generated scene. A Caption, icon, product card or other MG composed later can influence framing, but+it is not an object for the performer to touch, watch or reveal inside the generated video.++Capable video models can turn figurative wording into literal objects, events or transformations. Use+concrete visible language for intended gaze, gesture, movement, camera behavior and cuts when a+metaphor would introduce the wrong scene content. Social attitude and aesthetic shorthand remain+useful when they direct performance; an imagined object or event belongs in the prompt when it should+truly appear in the generated world.++Natural emphatic gestures are usually more reliable than asking fingers to display an exact number.+Let speech, Caption or MG convey the quantity while pointing and hand actions serve the performance.+An encounter also has edges: someone interrupted can first be occupied, and someone finishing can+begin to leave. Small causes make a clip feel like a piece of life rather than a pose bounded by the+encoder.++## Direct camera and cuts as part of the passage++Creator footage can benefit from pause-trim jump cuts. A podcast can cut with a speaker or toward a+meaningful reaction. A street interview can favor the guest and use the interviewer view for a+reaction. Stable framing, expressive acting and frequent edits are compatible choices.++One generated video can contain multiple shots, several speaking turns or a split-screen composition.+One Segment is not one speaker turn or one camera shot. Conversely, several Takes can reuse the same+character-and-scene image and meet at natural editorial cuts. A genuinely continuous shot calls for+the model relationship and direction that preserve that action. See+[Reference relationships](generated-dependencies.md) when deciding which visual or motion evidence+should condition each request.++A prompt-directed jump cut asks the generator for an edited rhythm; it does not inspect or trim the+returned media. When produced footage needs a deterministic cut, speed change or trim, use the+corresponding media operation and align the edited result before it becomes a SemanticTake.++## Size the request around the delivery++Use `hypit measure` on a spoken Segment at its intended pace, including time for meaningful+interaction, pauses and actions. [Script and time](../../creation/script-and-time.md#measure-before-choosing-durations)+owns the command, rounding and the relationship between estimated duration and real aligned time.+The target's delivery determines how much generated media the passage needs; the reference video's+seconds help explain its rhythm without becoming the target duration automatically.++Read the selected video model's supported request lengths from its installed vocabulary. Those values+constrain one generation request without defining the finished work's Segment structure or edited+beats. When the estimate does not fit one request cleanly, reconsider the performable passage: a brief+question and answer may belong together, a short line may gain a meaningful reaction, and a long+exchange may divide where its thought turns. Preserve the intended meaning and energy, then choose a+supported duration.++After production, normalized media supplies the real envelope and alignment supplies word positions.+Watch the result for engaged performance, correct speaking identity, legible interaction, intentional+camera behavior and the intended energy. Correct words alone do not establish that the scene works;+revise the visible or audible problem at the direction, reference, generation or media operation that+owns it.diff --git a/skills/hypit/references/playbooks/craft/visual-continuity.md b/skills/hypit/references/playbooks/craft/visual-continuity.mdindex b1e5f07e..455274c0 100644--- a/skills/hypit/references/playbooks/craft/visual-continuity.md+++ b/skills/hypit/references/playbooks/craft/visual-continuity.md@@ -6,10 +6,10 @@ and this page when a visible change makes the shared world hard to understand.## Preserve the relationship, change the view-Complementary podcast views share a location, lighting logic and conversation axis. A host on the-right looks toward the partner on the left; the partner's view reverses that attention. Microphone-entry, furniture and background help explain the two camera positions. The second view shows another-sector of the location rather than a mirrored duplicate of the first image.+Complementary podcast views share a location, palette, material language and conversation axis. A+host on the right looks toward the partner on the left; the partner's view reverses that attention.+Microphone entry, furniture and background help explain the two camera positions. The second view+shows another sector of the location rather than a mirrored duplicate of the first image.A plausible reverse view can be derived from the first host image because it already establishes theperson, setting and conversation axis. If the second image breaks the relationship, revise thediff --git a/skills/hypit/references/playbooks/formats/short-drama.md b/skills/hypit/references/playbooks/formats/short-drama.mdindex 60a91b72..755026aa 100644--- a/skills/hypit/references/playbooks/formats/short-drama.md+++ b/skills/hypit/references/playbooks/formats/short-drama.md@@ -19,8 +19,8 @@ remain legible.Measure the Script to understand speaking density, then leave the time that the intended pause,reaction and action need. The selected video model's supported request lengths constrain what can begenerated together without defining the story's scenes. [Script and time](../../creation/script-and-time.md#measure-before-choosing-durations)-owns measurement, while [generated performance](../craft/seedance-directing.md#size-the-request-around-the-delivery)-owns the current Seedance duration range and request judgment.+owns measurement, while [generated video direction](../craft/video-direction.md#size-the-request-around-the-delivery)+owns how the selected model's request range informs the performable passage.## Establish a small useful set of camera images@@ -59,10 +59,10 @@ The background carries story. It can reveal intimacy or status, explain why peopsupport a comic contrast, plant a useful object, or make a new scene immediately readable. Direct itsvibe with the same conviction as the character rather than leaving the model to produce generic space.-Related views share the facts that make the location recognizable: atmosphere, materials, light,+Related views share the facts that make the location recognizable: atmosphere, materials, palette,social setting and spatial relationship. Each camera also sees its own plausible part of that place.-A host framed against a window and their partner framed toward a dessert counter can belong to the-same warm shop without repeating an identical wall. [Image direction](../craft/image-direction.md#let-the-setting-belong-to-the-subject)+One camera can reveal the part of the place surrounding one character while another reveals a+different sector around their partner. [Image direction](../craft/image-direction.md#establish-the-place-with-a-few-details)owns this relationship between person, setting and view.## Let performance and editing carry the eventdiff --git a/skills/hypit/references/playbooks/formats/street-interview.md b/skills/hypit/references/playbooks/formats/street-interview.mdindex efe55a30..ff017857 100644--- a/skills/hypit/references/playbooks/formats/street-interview.md+++ b/skills/hypit/references/playbooks/formats/street-interview.md@@ -9,6 +9,9 @@ For the three-view method, generate a shared image containing both people and threlationship. Derive the guest close view and interviewer close view directly from it. In theinterviewer view, retaining part of the guest at the opposite edge keeps the exchange legible.The guest looks toward the interviewer, and the interviewer looks back across the same screen axis.+That attention and a comfortable microphone position give the reusable views their+[idle state](../craft/image-direction.md#choose-an-idle-state-for-the-encounter). Opening, reaction+and departure actions can then develop from this encounter in their respective video passages.```textshared street scene ──> guest close viewdiff --git a/skills/hypit/references/playbooks/formats/talking-head.md b/skills/hypit/references/playbooks/formats/talking-head.mdindex 4765bf60..7fc666ef 100644--- a/skills/hypit/references/playbooks/formats/talking-head.md+++ b/skills/hypit/references/playbooks/formats/talking-head.md@@ -11,6 +11,11 @@ space the video needs. [Image direction](../craft/image-direction.md) owns thatslightly right can leave room for an icon on the left; a table or the direction of their seated bodycan make that composition feel inhabited. Choose it for this layout, not as a universal UGC pose.+For a reusable frontal speaking image, explicitly keep the face toward the lens, with no head tilt+or rotation. A vivid attitude and an easy speaking gesture give this settled view life. The+[idle principle](../craft/image-direction.md#choose-an-idle-state-for-the-encounter) relates that pose+to addressing the viewer; the generated performance can move and react within the encounter.+Use that same image and the person's recurring voice reference for every ordinary talking Take.Each Take can return to the same useful visual premise and contribute another piece of the editedperformance.@@ -24,9 +29,10 @@ Take independently because this work wants edited speech rather than an unbrokenFor a single presenter returning to one useful camera image through natural edited cuts, `speaker-v1`from `@hypit/seedance-kits` is a tested fit. It combines that character-and-scene image, one voicereference, Script dialogue, a Recipe for recurring direction, and optional action Text for the passage.-[Directing generated performance](../craft/seedance-directing.md) shows its assembly and reference-relationship. Read the selected installed template for its actual Recipe choices. A work whose camera,-cast, or performance relationship differs can use another Kit or ordinary authored direction.+The installed Kit package owns its exact assembly, reference order and Recipe choices.+[Generated video direction](../craft/video-direction.md) explains what the image, voice, dialogue and+passage direction each contribute. A work whose camera, cast, or performance relationship differs can+use another Kit or ordinary authored direction.A fitting Speaker Recipe can combine stable framing with`edit-rhythm: pause-trim-jump-cuts`. The camera can@@ -47,7 +53,7 @@ knowing shrug. The free hand makes relaxed emphatic gestures; keep the microphon```This illustrates attitude and a few visible beats; it does not prescribe every creator's personality.-See [Directing generated performance](../craft/seedance-directing.md) for listeners, gestures and cuts.+See [Generated video direction](../craft/video-direction.md) for listeners, gestures and cuts.## Let speech and graphics do different workdiff --git a/skills/hypit/references/playbooks/formats/two-person-podcast.md b/skills/hypit/references/playbooks/formats/two-person-podcast.mdindex 63863cdd..43ebfe62 100644--- a/skills/hypit/references/playbooks/formats/two-person-podcast.md+++ b/skills/hypit/references/playbooks/formats/two-person-podcast.md@@ -10,6 +10,10 @@ complementary view: opposite screen position and gaze, microphone entering fromand another visible sector of the same location. The first host view establishes the shared world;the complementary view changes what the other camera can see.+These [idle views](../craft/image-direction.md#choose-an-idle-state-for-the-encounter) hold an easy+conversational posture: each host turns toward their partner, with their face readable from the+chosen camera. Their attitude is already present and can develop through different speaking turns.+The worked restaurant example has this reference structure:```text@@ -22,8 +26,9 @@ both host views ──────────> optional split-screen opening imMost new views are one hop from their useful parent. Derive lifestyle scenes from the main host,not from one another. Product-holding views inherit their own host's camera and add the actual-product reference. Preserve gaze, lighting and microphone placement while changing the intended-prop state. File imports are valid inputs even when those images were generated outside Source.+product reference. Preserve gaze, the established setting and microphone placement while changing+the intended prop state. File imports are valid inputs even when those images were generated outside+Source.[Podcast and interview image examples](../craft/examples/conversation-images.md) preserve theconcrete English production directions and explain what each reference is responsible for.diff --git a/skills/hypit/references/playbooks/index.md b/skills/hypit/references/playbooks/index.mdindex 99cbe2b5..61424122 100644--- a/skills/hypit/references/playbooks/index.md+++ b/skills/hypit/references/playbooks/index.md@@ -24,7 +24,7 @@ not need a matching playbook before it can be understood or made.| --- | --- || [Directing generated images](craft/image-direction.md) | phone-video realism, character presence, image prompts, materials and palette, or preparing a useful visual reference || [Voice and performance](craft/voice-and-performance.md) | how Segment performances create semantic time, who is A-roll, recurring voice identity, visual A-roll presentations, or genuinely independent narration |-| [Directing generated performance](craft/seedance-directing.md) | using a video Kit, directing attitude and small actions, natural cuts, listeners, or sizing Takes |+| [Directing generated video](craft/video-direction.md) | choosing a generation relationship, directing visible performance or silent action, camera behavior, cuts, or request duration || [Reference relationships](craft/generated-dependencies.md) | deciding which images or Takes should depend on which references || [Visual continuity](craft/visual-continuity.md) | complementary camera views, gaze, prop state, or what must remain coherent through a cut || [B-roll](craft/b-roll.md) | exact cue coverage versus montage, short display windows, source playback, J-cuts, or adjacent Selections |diff --git a/skills/hypit/references/production/authoring.md b/skills/hypit/references/production/authoring.mdindex 4a496711..38d205ee 100644--- a/skills/hypit/references/production/authoring.md+++ b/skills/hypit/references/production/authoring.md@@ -3,7 +3,9 @@Read this when turning the current Treatment into Author Sources, Recipes, Runs, project components,and Builds, or when revising an existing production.-[Source syntax](source-syntax.md) explains imports, references and language forms.+[Script and semantic time](../creation/script-and-time.md) explains target wording, Segments, Roles,+Caption Cue handoffs and semantic anchors. [Source syntax](source-syntax.md) explains imports,+references and the language around that Script.[Composing Tracks](tracks.md) connects the visual and audio roles; [Track authoring](track-authoring.md)and [Caption authoring](caption-authoring.md) explain creating a new project component for them.[System relationships](system.md) connects these concepts to execution and Results;@@ -20,6 +22,18 @@ Begin with the work the Treatment describes, not with a package inventory. Ident- the genuinely clock-based events;- the final Film or other deliverables.+Bring the relevant directing knowledge into those decisions: use+[Script and semantic time](../creation/script-and-time.md) for the verbal structure and the meanings+other layers will follow,+[image direction](../playbooks/craft/image-direction.md) for generated camera images,+[video direction](../playbooks/craft/video-direction.md) for generated performance and action,+[voice and performance](../playbooks/craft/voice-and-performance.md) for A-roll and recurring voices,+[B-roll](../playbooks/craft/b-roll.md) for coverage,+[Caption](../playbooks/craft/captions.md) for speech-linked text, and+[graphic composition](../playbooks/craft/graphic-compositions.md) for MG and designed visual state.+These pages establish what the authored relationship should accomplish. Installed vocabulary then+supplies the exact language for expressing it.+Author those relationships explicitly. Script Selections and Moments carry meaning through producedspeech into real time. Track and Film elements arrange the resulting picture and sound. One Sourcecarries the whole creative program; its cuts are relationships inside that program.diff --git a/skills/hypit/references/production/tracks.md b/skills/hypit/references/production/tracks.mdindex 41d1d2ba..805fdb2f 100644--- a/skills/hypit/references/production/tracks.md+++ b/skills/hypit/references/production/tracks.md@@ -124,7 +124,7 @@ Semantic structure also supports a wordless passage. It has no speaking A-roll,Script Segment receives its actual boundaries from prepared media and remains addressable throughthe assembled SemanticTrack. Semantic identity here means that the work can refer to the passage andits boundaries; it does not classify the passage or require spoken words.-[Media preparation](media.md#wordless-passages-use-media-boundaries) owns that construction.+[Media preparation](media.md#empty-segments-use-their-media-boundaries) owns that construction.Every Take contributes its Segment boundaries to the assembled semantic time. When its preparedmedia has no audio stream, Speech Track emits no audio clip for that Take; when it has no visual