---
name: clip-character-swap-brand-boards
description: 'Use when swapping a person in a short live-action clip (sports, street, events) for the project character (one photo) while adding a prop or situation, rebranding the background billboards and signs to our brand, then combining the original audio in the editor and exporting. Covers the Seedance 2.5 video swap, sound on → regenerate with sound off on failure, brand spelling review, and merging the original audio. Example triggers: swap the person in this clip with my character and rebrand the billboards, replace stadium banners with our brand, change only the person and keep the original sound, if generation fails turn the sound off and try again, swap the person in this video for Yujeong and make the boards our brand, keep the original audio.'
---

# Swap a person in a clip + rebrand the background boards + merge the original audio

When to follow: only for requests to swap a specific person in one live-action clip for a character (one photo), change the lettering on background billboards and signs to a given brand, and keep the original sound. For dance videos where moves and song sync are the point, use a dance swap skill and ignore this one. UI names below are given in English; if the app shows them in another language (for example Korean), find the item with the same meaning. Write reports and comments in the user's language.

## Ask the user before starting
The point of this skill is not to remake the example but to make the user's own video. Before starting, ask the questions below together, in one message.
- Skip anything the request already answers.
- If the user says "you decide" or "use the defaults", go with the defaults in parentheses.
- If the user seems to have no idea yet, briefly suggest 2–3 options that differ from the example.
- Once answered, show a one-line summary of what was decided, then start.

1. Which source video, and who to replace? Distinguish them by clothes or position.
2. Which character should they become? Point to a photo or sheet.
3. Any prop or situation to add? E.g. running while holding up a tablet with the finished video (default: none)
4. What brand lettering and design for the boards? Exact spelling, capitalization, address, background color (default: the official spelling, white text on a dark board)
5. Keep the original sound? (default: yes)

## 1. Rules
- Input: one source video + one character photo (several angles in one image is better) + the brand's spelling (check the official site).
- Output: same ratio and length as the source, 1080p, saved to the folder the user specifies. Sound is the original audio.
- Generation is a Seedance 2.5 (`seedance-2.5`) video edit with attachmentIds [source video, character photo]. durationSeconds is the source length rounded up (16 for 15.13 s).
- Sound: first generate with `generateAudio: true`; if it fails, regenerate with `false` and merge the original audio in the editor. Even if it succeeds, the final sound is the original audio.
- AI easily misspells brand lettering. Passing the spelling review is the pass criterion.
- Credits (reference; confirm with the estimate): 1080p 16 s 9:16 estimate 1,255, actual charge 1,027–1,063. Failed generations are charged 0.

## 2. Steps
1. Register the steps with `update_task_scope`: check → generate → merge → export and review.
2. Open the source with `get_project_file` and check length and ratio. View the character photo with `includeImage: true` and write down face, hair and clothes.
3. Check the brand's spelling with `web_fetch` (official site). E.g. uppercase wordmark YOUVICO, address youvico.com, base color #0A0B0E.
4. In the editor, make a `New edit`. Never touch existing edits. Putting the source on V1 with `add_clip_to_timeline` brings its sound onto A1.
5. Call `estimate_ai_generation` with the same arguments, then `start_ai_generation` (maxCredits = estimate). The prompt is §6.
6. Wait for completion. It is handy to hand `run_subagent` (sonnet, low) only the job of polling `get_ai_generation_status` every 30 seconds.
7. Rename the result with `rename_file`: `<topic>_<character>_<scene>_seedance25_1080p_[silent_]vN.mp4`.
8. Put the result on an upper track (V2 or V3) at 0 s with `add_clip_to_timeline`. A clip generated without sound gets no sound clip attached.
9. Once the spelling review (§3) passes, delete the generated clip's sound clip and the failed version clips with `delete_clips`. Trim the source V1 and A1 to the generated clip's length with `trim_clip` (includeLinked) (e.g. 15.133 → 14.867 s).
10. Check the layout with `get_timeline_layout`: the generated clip on top, the original audio on A1, and the same end time.
11. Export with `export_draft` (the specified folder, name `<topic>_<character>_<scene>_final_originalaudio.mp4`). Then confirm UPLOADED with `get_project_file`, `set_file_status` review, and `create_comment` a task log at 0 s (model, attachments, history, what needs checking).

## 3. Checks
- **Spelling review**: in the editor, move with `seek_editor` every 2–4 seconds and capture the canvas with `capture_app_screen`. Compare the board lettering letter by letter.
  - If it looks small, enlarge the generated layer with `set_layer_transform` to scale 2–3 and move x and y to zoom in on the boards to read them.
  - When done zooming, always restore scale 1, x 0.5, y 0.5.
  - Zooming crops the edges, so make the final call again at 1x.
- **Person and prop**: check that the character's face, hair and clothes match, that the prop (an iPad etc.) stays in hand, and that the original moves and path are kept.
- **Review tool limits**: reading the editor canvas with `inspect_app_media` returns a white screen, so use `capture_app_screen`. Exported mp4s can't be decoded and preview captures often fail. In that case, note in the report that a person has to play the final file to check the picture and sound sync.

## 4. When it fails
- **Misspelling** (real cases "youvic.com", "YOUVICC"): spell the letters out one by one in the prompt (Y, O, U, V, I, C, O, the last letter is O, not C). Describe the banner design in words only.
- **PROVIDER_REJECTED**: attaching a board design image (an image with brand lettering) as a reference was rejected with sound both on and off. Never attach reference images that contain lettering; attach only the source and the character photo. Then regenerate with sound off.
- **SERVICE_UNAVAILABLE**: regenerate once with the same settings and a new requestId. If it keeps happening, a close-up of a real person's face may be the cause.
  - Generate the video cut by cut.
  - For a blocked close-up cut, make a first frame with Nano Banana Pro and replace the cut with Seedance image-to-video.
- **Length difference**: the generated clip comes out 0.1–0.3 s shorter than the source. Don't change the speed; trim the end of the original audio to the generated length.
- If the same defect appears twice, stop just editing the prompt and change the attachments, range or method.

## 5. Report format
1. Result file (name, folder, length, status)
2. History (success or failure per version, and why)
3. Moments checked and the outcome (spelling, person)
4. What a person should check (play the final file, sound sync, boards that are covered or far away, rights to the source video)
5. Failed files not cleaned up
6. Credits (table of actual charges; failures are 0)

## 6. Prompt (the successful sound-off version)
Edit the attached video (first reference). Replace only the <description of the person to replace> with the young Korean woman shown in the identity photo (second reference): <hair, face, makeup>, wearing <the outfit in the photo>. She is <situation: a video editor carrying a tablet (iPad) in one hand, holding it up with a finished video on screen, hurrying across the pitch to get her work approved> — <the original moves, on the same path and timing>. Her face must stay clearly recognizable as the person in the second reference, well exposed and in sharp focus.
Replace every advertising board / LED banner around the stadium with a clean <brand> advertisement: dark navy-black board with only two pieces of white text, repeated: the large bold uppercase word "YOUVICO" — seven letters Y, O, U, V, I, C, O, the last letter is O, not C — and the smaller lowercase web address "youvico.com" — y, o, u, v, i, c, o, dot, c, o, m — with the letter o between c and the dot. Big, simple, evenly spaced letters that stay sharp and correctly spelled in every frame.
Keep everything else exactly as in the original video, frame by frame: <people to keep>, the ball, the camera movement and framing, the crowd, the stadium lighting and the pitch. Same duration, starts on the same first frame, same cuts as the original. Sharp, high-detail live-action footage. No captions, no app interface, no watermark.

configs: `{"resolution":"1080p","aspectRatio":"<source ratio>","durationSeconds":<source length rounded up>,"generateAudio":false}`

Change log: v1.0 2026-10-19 first written from the soccer work (Yujeong getting iPad sign-off + YOUVICO boards), including the close-up failure handling from the kart chase work / 2026-10-19 added questions before starting