| name | kai-video |
| description | Produce video scripts and clipping plans for TikTok, YouTube Shorts, Instagram Reels, and long-form YouTube. Generates hook-first scripts optimized for each platform's algorithm, plus a clipping plan to extract short-form from long-form content. Use when "video script", "TikTok script", "YouTube script", "Reels script", "Shorts script", "video content", "clipping plan", "video ideas", or any request to create video content for social platforms. |
/kai-video — shootable scripts and a defensible clip list
Kai root note: knowledge/, harness/, and scripts/ paths in this skill live in the Kai install, not the user's project. Resolve them against the first ancestor directory of this SKILL.md that contains a knowledge/ folder (the Kai plugin root, ~/.claude/kai, or the kai-cmo-harness repo). MARKETING.md, memory/, and any output files live in the current project. If a referenced scripts/ command is not available in this install, say so, skip it, and continue with the file-based guidance — never fabricate its output.
Objective
Scripts someone can shoot without asking a follow-up question, and — where long-form source exists — a clipping plan naming which moments become short-form, at which timestamps, and why. Hook-first and platform-specific: the first three seconds decide whether the rest of the work matters.
Done when
Work type social-post — floor E5/C2/O3 (harness/eco-floors.yaml), contract harness/skill-contracts/social-post.yaml.
- E5 — the video is live and a non-actor read the public permalink back against the approved script and cut. A script file in
workspace/ is E1; approval of the exact script is E3. This skill reaches the artifact; publishing is a separate, approved step.
- C2 —
four_us_score at 10/16 and banned_word_check clean on the script copy, plus the per-script bar below.
- O3 — reach, engagement rate, profile clicks, and link clicks read from platform insights at 7 days, against a baseline recorded before publish.
Per-script bar: hook lands in the first 3 seconds (no intros, no "hey guys", no logo animation) · one idea per short-form video · zero banned words and zero AI slop · a CTA that closes naturally rather than being bolted on · visual direction included, not words alone · length appropriate to the platform.
Constraints
- Read
MARKETING.md from the project root before asking the user anything. If it does not exist, build it from the codebase — CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, email/ad/analytics config — using the template from /kai-email-system, and confirm the draft.
- Know these before scripting: topic, target platforms, format (talking head, screen recording, b-roll, animation), length band (15–60s short-form or 5–15min long-form), goal, and any existing content to adapt from.
- Load the platform guide before writing for that platform — the algorithms differ and the pacing rules are not transferable.
- Every clip row carries a source timestamp or file locator. If the source is a guest, customer, podcast, or third-party show, mark approval status before export and follow
harness/references/transcript-video-research-rules.md.
- Clip plans are dry runs. Publishing or upload requires human approval.
- Vary the hook formula across videos. Repeating one formula across a slate trains the audience to skip.
Context
| Need | Load |
|---|
| Video content mechanics | knowledge/playbooks/video-content-creation.md |
| TikTok | knowledge/channels/tiktok-algorithm.md |
| YouTube (Shorts and long-form) | knowledge/channels/youtube.md |
| Instagram Reels | knowledge/channels/instagram.md |
| Clipping long-form into short-form | knowledge/playbooks/video-clipping-automation-workflow.md |
| Any transcript, caption, podcast, webinar, or third-party source | harness/references/transcript-video-research-rules.md |
| Product, ICP, voice, channels | MARKETING.md (project root) |
Short-form script (15–60s) carries: platform, length, format, HOOK (0–3s, pattern interrupt — question, bold claim, or visual surprise), BODY (3–45s, one idea and one takeaway with bracketed visual direction), CTA (last 3–5s), timestamped on-screen text overlays, 3–5 platform-appropriate hashtags, and a trending-audio suggestion or "original audio".
Long-form script (5–15min) carries: HOOK (0–30s previewing the payoff), INTRO (30s–1min: context, credibility, structure promise), three content sections with visual direction, RECAP + CTA, chapter timestamps, and a thumbnail concept (3–5 words of title text, expression, key visual).
Hook formulas — rotate across a slate:
| Type | Formula | Example |
|---|
| Question | "Did you know [surprising fact]?" | "Did you know 73% of leads call after hours?" |
| Bold claim | "[Contrarian statement]" | "Cold email is dead. Here's what replaced it." |
| Problem | "If you're struggling with [X]..." | "If your landing page converts under 3%..." |
| Result | "We went from [bad] to [good] in [time]" | "We went from 2% to 11% conversion in 3 weeks" |
| List | "[Number] [things] that [outcome]" | "5 emails every SaaS needs on day one" |
Clip scoring — score every candidate before scripting it, 1–5 per factor:
| Factor | Question |
|---|
| Hook | Do the first 3 seconds create a clear reason to keep watching? |
| Standalone clarity | Can the viewer understand the moment without the full source? |
| Proof | Does it include a concrete example, result, quote, or demo moment? |
| Tension | Does it contain contrast, surprise, objection, stakes, or a reveal? |
| Source safety | Is the claim attributable and cleared for use? |
Clips scoring 18/25 or higher are production candidates. Lower scores go to workspace/video/clipping-plan/_kill-list.md with the reason.
Output goes to workspace/video/: _video-plan.md, short-form/ (per-platform scripts), long-form/, clipping-plan/clips-from-[source].md, _quality-report.md.
Escalate when
- Source footage rights, guest approval, or customer permission for a clip is unconfirmed.
- A claim in the script needs a number that has no source.
- The requested length or format conflicts with the platform's current norms in the loaded channel guide.
- The user wants the video rendered rather than scripted — that is
/kai-video-production.
- Anything would be uploaded or published before human approval.
