Use when an editor or videographer needs production direction — beat-by-beat storyboard, footage to shoot, b-roll, text overlays, music and pacing, transitions, CTA end frame, and per-channel export specs. This is the EDIT instruction, not the spoken script. Trigger on 'video brief', 'editor brief', 'storyboard', 'brief for the video editor', 'how should this video be cut', 'we have the footage and no direction'. Also use when raw clips exist and nobody knows what the final should look like. Not for — the words said on camera, see `04-script-video-global`; briefing a creator to film their own, see `06-ugc-egc-brief-global`; resizing a finished video, see `50-asset-resize-global`.
A good video brief means the shooter knows the setup and the editor knows the cut without a single explanatory call. The first three seconds must work as a standalone clip.
How this differs from 04-script-video-global: the script is the SPOKEN CONTENT (what is said, structured hook-body-CTA). This brief is the PRODUCTION DIRECTION (what to shoot, how to cut, what music, what overlays, how to export). If no script exists, run 04-script-video-global first, then paste its lines into the "Dialogue / VO" column of the storyboard below.
Information gathering
Read .agents/product-marketing-context-global.md, the script from 04-script-video-global, and the asset list if available. If information is missing, ask up to 4 questions:
Where does the video run, and how long? TikTok organic, Reels, Meta ads, YouTube — 15s, 30s, 60s, or 3-5 minutes?
Funnel stage and objective? TOFU, MOFU, or BOFU — what must this video accomplish?
Who appears, and what is available to shoot? Founder, staff, real customer, or voiceover only — is there a physical product to film?
Production setup? In-house or contracted, shoot date, publish date, and who edits?
Principles
Complete enough that the editor never asks. Every cutting decision belongs in the brief.
Shoot more takes than you need — at least three per beat, so the edit can pick the best.
The first three seconds must stand alone. Clipped out on their own, they should still make sense and still hook.
Always attach a reference video. Describing a style in words is not enough.
Multiple formats need separate briefs. Do not run TikTok organic and a Meta ad off one brief.
The CTA lives in the last five seconds and needs a clear end frame (text plus next step).
Clear the music and the claims. Use platform commercial-music libraries or licensed tracks, and follow FTC endorsement rules when a creator or customer appears.
Workflow
1. Lock the concept and reference
One-sentence idea (readable in a single pass), tone (serious, playful, urgent, inspiring, educational), and 1-2 reference videos annotated with what to take from each.
2. Write the beat-by-beat storyboard
Split the video by timeline: Hook (0-3s) -> Beat 1..N -> CTA (final 5s). Each beat states the shot, the dialogue or VO (from the script), the text overlay, and the transition.
3. Write the shooting direction
Lighting, background, camera angle, gear, dos and don'ts — so the shooter sets up correctly the first time.
4. Write the editing direction
Music (mood, BPM, source, license), cut style, color grade, subtitle style — so the editor matches pacing and brand.
5. Lock deliverables and channel specs
Which files, which dimensions, which deadline — including thumbnail or cover frame.
# Video Brief — [Project name]
## Video overview
| Item | Detail |
|------|--------|
| Project name | |
| Channel | TikTok / Reels / Meta ads / YouTube |
| Target duration | 15s / 30s / 60s / 3-5 min |
| Funnel stage | TOFU / MOFU / BOFU |
| On camera | |
| Shoot date / publish date | |
| Shooter / editor | |
## Concept
- One-sentence idea: [what this video is about]
- Tone: [Serious / Playful / Urgent / Inspiring / Educational]
- Reference video: [link + what to take from it]
## Storyboard — beat by beat
| Beat | Time | Shot | Dialogue / VO | Text overlay | Transition |
|------|------|------|---------------|--------------|------------|
| Hook | 0-3s | | [from 04-script-video-global] | | |
| Beat 1 | 3-Xs | | | | |
| Beat 2 | | | | | |
| Beat 3 | | | | | |
| CTA | final 5s | [end frame: CTA + logo + contact] | | [CTA text] | |
## Shooting direction
- Lighting: [natural / ring light / studio]
- Background: [color / setting / location]
- Camera angle: [eye level / slightly low / overhead]
- Gear: [phone / camera — vertical or horizontal]
- Do: at least three takes per beat; shoot enough B-roll for the explanatory sections
- Do not: shoot into the light; change setting mid-beat without a reason
## Editing direction
- Music: [mood + BPM + source — confirm the license covers paid ads if this is an ad]
- Cut style: [fast under 2s / slow / mixed by beat]
- Color grade: [bright and airy / warm / per brand]
- Subtitles: [auto plus manual cleanup / manual / none]
- Subtitle font: [heading font] Bold, light fill, contrasting outline — legible on mobile
- Text overlay: [heading font] and brand colors, kept inside the safe zone
- Disclosure: add "#ad" or "Paid partnership" on screen and in caption when a creator or incentivized customer appears
## Deliverables
| File | Spec | Deadline |
|------|------|----------|
| Raw footage | [storage location + format] | |
| Final edit | [dimensions per channel — see spec table] | |
| Thumbnail / cover frame | 1280x720 (YouTube) or a 9:16 vertical frame | |
| Alternate cuts (if needed) | [15s cut from the 60s master, etc.] | |
Channel specs
Channel
Ratio
Dimensions
Suggested length
Notes
TikTok / Reels / Shorts
9:16
1080x1920
15-60s
Hook in 0-3s; safe zone 150px top / 300px bottom, plus ~140px right for UI icons
Meta Feed
1:1 or 4:5
1080x1080 / 1080x1350
15-60s
Most viewers watch muted — subtitles are mandatory
Meta ads
1:1 + 9:16
export both
15-30s
CTA lands earlier than in organic
YouTube in-stream
16:9
1920x1080
3-5 min
Separate 1280x720 thumbnail
YouTube Shorts
9:16
1080x1920
under 60s
Same safe zones as Reels
LinkedIn
1:1 or 16:9
1080x1080 / 1920x1080
30-90s
Muted autoplay — burn in captions
Export MP4 (H.264). Name files with the convention: [Campaign]_[Channel]_[Size]_[Stage]_[Version]_[Status].mp4.
Position in the campaign timeline
Per the designer timeline in 41-campaign-asset-list-global, video and thumbnails are complex assets — deadline Launch - 5 days. Concept and storyboard are approved at the T-7 checkpoint, before the shoot.
Related skills
04-script-video-global: write the spoken lines first; this brief covers production (run it first if no script exists).
06-ugc-egc-brief-global: creator and customer-generated video uses its own brief; this skill covers brand-produced video.
41-campaign-asset-list-global: where the video sits in the asset list and its deadline.
42-image-brief-global: brief the static thumbnail that ships with the video.
46-brand-guideline-global: subtitle font, overlay colors, and end-frame logo rules.
47-design-review-global: review the cut before publishing (hook, pacing, CTA, channel spec).
Quality checklist
Script or dialogue exists (from skill 04) before the storyboard is written
Storyboard covers every beat: hook 0-3s, body, CTA in the final 5s
The first three seconds work as a standalone clip
Every beat has a shot, dialogue, text overlay, and transition
Shooting direction covers lighting, background, angle, gear, and take count
Editing direction covers music, cut style, color grade, and subtitle style
Subtitles and overlays use brand fonts and colors, inside the safe zone
End frame carries the CTA, logo, and next step
Deliverables list files, specs, and deadlines per channel
A reference video is attached with notes on what to take from it
Music license and disclosure requirements are confirmed
1---2name: 44-video-editor-brief-global3description: Use when an editor or videographer needs production direction — beat-by-beat storyboard, footage to shoot, b-roll, text overlays, music and pacing, transitions, CTA end frame, and per-channel export specs. This is the EDIT instruction, not the spoken script. Trigger on 'video brief', 'editor brief', 'storyboard', 'brief for the video editor', 'how should this video be cut', 'we have the footage and no direction'. Also use when raw clips exist and nobody knows what the final should look like. Not for — the words said on camera, see `04-script-video-global`; briefing a creator to film their own, see `06-ugc-egc-brief-global`; resizing a finished video, see `50-asset-resize-global`.4license: MIT5---67# Video Editor Brief (Global)
89A good video brief means the shooter knows the setup and the editor knows the cut without a single explanatory call. The first three seconds must work as a standalone clip.
1011**How this differs from `04-script-video-global`:** the script is the SPOKEN CONTENT (what is said, structured hook-body-CTA). This brief is the PRODUCTION DIRECTION (what to shoot, how to cut, what music, what overlays, how to export). If no script exists, run `04-script-video-global` first, then paste its lines into the "Dialogue / VO" column of the storyboard below.
1213## Information gathering
1415Read `.agents/product-marketing-context-global.md`, the script from `04-script-video-global`, and the asset list if available. If information is missing, ask up to 4 questions:
16171. **Where does the video run, and how long?** TikTok organic, Reels, Meta ads, YouTube — 15s, 30s, 60s, or 3-5 minutes?
182. **Funnel stage and objective?** TOFU, MOFU, or BOFU — what must this video accomplish?
193. **Who appears, and what is available to shoot?** Founder, staff, real customer, or voiceover only — is there a physical product to film?
204. **Production setup?** In-house or contracted, shoot date, publish date, and who edits?
2122## Principles
23241. **Complete enough that the editor never asks.** Every cutting decision belongs in the brief.
252. **Shoot more takes than you need** — at least three per beat, so the edit can pick the best.
263. **The first three seconds must stand alone.** Clipped out on their own, they should still make sense and still hook.
274. **Always attach a reference video.** Describing a style in words is not enough.
285. **Multiple formats need separate briefs.** Do not run TikTok organic and a Meta ad off one brief.
296. **The CTA lives in the last five seconds** and needs a clear end frame (text plus next step).
307. **Clear the music and the claims.** Use platform commercial-music libraries or licensed tracks, and follow FTC endorsement rules when a creator or customer appears.
3132## Workflow
3334### 1. Lock the concept and reference
3536One-sentence idea (readable in a single pass), tone (serious, playful, urgent, inspiring, educational), and 1-2 reference videos annotated with what to take from each.
3738### 2. Write the beat-by-beat storyboard
3940Split the video by timeline: Hook (0-3s) -> Beat 1..N -> CTA (final 5s). Each beat states the shot, the dialogue or VO (from the script), the text overlay, and the transition.
4142### 3. Write the shooting direction
4344Lighting, background, camera angle, gear, dos and don'ts — so the shooter sets up correctly the first time.
4546### 4. Write the editing direction
4748Music (mood, BPM, source, license), cut style, color grade, subtitle style — so the editor matches pacing and brand.
4950### 5. Lock deliverables and channel specs
5152Which files, which dimensions, which deadline — including thumbnail or cover frame.
5354## Output structure
5556File name: `video-editor-brief-[name]-[YYYYMMDD].md`
5758```markdown
59# Video Brief — [Project name]
6061## Video overview
62| Item | Detail |
63|------|--------|
64| Project name | |
65| Channel | TikTok / Reels / Meta ads / YouTube |
66| Target duration | 15s / 30s / 60s / 3-5 min |
67| Funnel stage | TOFU / MOFU / BOFU |
68| On camera | |
69| Shoot date / publish date | |
70| Shooter / editor | |
7172## Concept
73- One-sentence idea: [what this video is about]
74- Tone: [Serious / Playful / Urgent / Inspiring / Educational]
75- Reference video: [link + what to take from it]
7677## Storyboard — beat by beat
78| Beat | Time | Shot | Dialogue / VO | Text overlay | Transition |
79|------|------|------|---------------|--------------|------------|
80| Hook | 0-3s | | [from 04-script-video-global] | | |
81| Beat 1 | 3-Xs | | | | |
82| Beat 2 | | | | | |
83| Beat 3 | | | | | |
84| CTA | final 5s | [end frame: CTA + logo + contact] | | [CTA text] | |
8586## Shooting direction
87- Lighting: [natural / ring light / studio]
88- Background: [color / setting / location]
89- Camera angle: [eye level / slightly low / overhead]
90- Gear: [phone / camera — vertical or horizontal]
91- Do: at least three takes per beat; shoot enough B-roll for the explanatory sections
92- Do not: shoot into the light; change setting mid-beat without a reason
9394## Editing direction
95- Music: [mood + BPM + source — confirm the license covers paid ads if this is an ad]
96- Cut style: [fast under 2s / slow / mixed by beat]
97- Color grade: [bright and airy / warm / per brand]
98- Subtitles: [auto plus manual cleanup / manual / none]
99- Subtitle font: [heading font] Bold, light fill, contrasting outline — legible on mobile
100- Text overlay: [heading font] and brand colors, kept inside the safe zone
101- Disclosure: add "#ad" or "Paid partnership" on screen and in caption when a creator or incentivized customer appears
102103## Deliverables
104| File | Spec | Deadline |
105|------|------|----------|
106| Raw footage | [storage location + format] | |
107| Final edit | [dimensions per channel — see spec table] | |
108| Thumbnail / cover frame | 1280x720 (YouTube) or a 9:16 vertical frame | |
109| Alternate cuts (if needed) | [15s cut from the 60s master, etc.] | |
110```
111112## Channel specs
113114| Channel | Ratio | Dimensions | Suggested length | Notes |
115|---------|-------|------------|------------------|-------|
116| TikTok / Reels / Shorts | 9:16 | 1080x1920 | 15-60s | Hook in 0-3s; safe zone 150px top / 300px bottom, plus ~140px right for UI icons |
117| Meta Feed | 1:1 or 4:5 | 1080x1080 / 1080x1350 | 15-60s | Most viewers watch muted — subtitles are mandatory |
118| Meta ads | 1:1 + 9:16 | export both | 15-30s | CTA lands earlier than in organic |
119| YouTube in-stream | 16:9 | 1920x1080 | 3-5 min | Separate 1280x720 thumbnail |
120| YouTube Shorts | 9:16 | 1080x1920 | under 60s | Same safe zones as Reels |
121| LinkedIn | 1:1 or 16:9 | 1080x1080 / 1920x1080 | 30-90s | Muted autoplay — burn in captions |
122123Export MP4 (H.264). Name files with the convention: `[Campaign]_[Channel]_[Size]_[Stage]_[Version]_[Status].mp4`.
124125## Position in the campaign timeline
126127Per the designer timeline in `41-campaign-asset-list-global`, video and thumbnails are complex assets — deadline Launch - 5 days. Concept and storyboard are approved at the T-7 checkpoint, before the shoot.
128129## Related skills
130131- `04-script-video-global`: write the spoken lines first; this brief covers production (run it first if no script exists).
132- `06-ugc-egc-brief-global`: creator and customer-generated video uses its own brief; this skill covers brand-produced video.
133- `41-campaign-asset-list-global`: where the video sits in the asset list and its deadline.
134- `42-image-brief-global`: brief the static thumbnail that ships with the video.
135- `46-brand-guideline-global`: subtitle font, overlay colors, and end-frame logo rules.
136- `47-design-review-global`: review the cut before publishing (hook, pacing, CTA, channel spec).
137138## Quality checklist
139140- [ ] Script or dialogue exists (from skill 04) before the storyboard is written
141- [ ] Storyboard covers every beat: hook 0-3s, body, CTA in the final 5s
142- [ ] The first three seconds work as a standalone clip
143- [ ] Every beat has a shot, dialogue, text overlay, and transition
144- [ ] Shooting direction covers lighting, background, angle, gear, and take count
145- [ ] Editing direction covers music, cut style, color grade, and subtitle style
146- [ ] Subtitles and overlays use brand fonts and colors, inside the safe zone
147- [ ] End frame carries the CTA, logo, and next step
148- [ ] Deliverables list files, specs, and deadlines per channel
149- [ ] A reference video is attached with notes on what to take from it
150- [ ] Music license and disclosure requirements are confirmed
Run npx skillmds@latest add gabrielmoreira/44-video-editor-brief-global in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when an editor or videographer needs production direction — beat-by-beat storyboard, footage to shoot, b-roll, text overlays, music and pacing, transitions, CTA end frame, and per-channel export specs. This is the EDIT instruction, not the spoken script. Trigger on 'video brief', 'editor brief', 'storyboard', 'brief for the video editor', 'how should this video be cut', 'we have the footage and no direction'. Also use when raw clips exist and nobody knows what the final should look like. Not for — the words said on camera, see `04-script-video-global`; briefing a creator to film their own, see `06-ugc-egc-brief-global`; resizing a finished video, see `50-asset-resize-global`. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.