agentleFS
sanky369sanky369/vibe-building-skills/skills/creative/talking-head/SKILL.md

talking-head

Skill30 starsChanged 5 months agoMITView on GitHub

Plan presenter-led and UGC-style videos: choose the presenter archetype, define styling, setting, lighting, and framing, write the hook/body/CTA script skeleton, and produce keyframe prompts for the repo's FAL.ai pipeline. Use whenever the user wants a talking-head video, presenter video, UGC ad, testimonial, founder video, explainer with a person on camera, spokesperson content, or 'someone talking about my product' — even if they just say 'I need a video of a person explaining this'. Produces a Talking Head Video Spec: presenter definition, look/setting/lighting/framing decisions, timed script skeleton, and generation-ready keyframe prompts for fal-ai/nano-banana-pro.

  • Reads credentials

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use for any video fronted by a person: testimonials, UGC-style ads, educational/explainer videos, founder updates, product demos with a …

    line 12
  2. Very specific:

    No brand style defined and consistency matters → run skills/creative/creative-strategist first.

    line 16
  3. Distinctive:

    Ask in one tight batch, only what's missing:

    line 20
  4. Distinctive:

    Commit to one archetype with a one-line reason.

    line 40
  5. Very specific:

    If FAL_API_KEY (or FAL_KEY) is set, generate via the repo CLI (docs/fal_api.py, model fal-ai/nano-banana-pro):

    line 65
  6. Distinctive:

    Always deliver this structure:

    line 79
  7. Distinctive:

    No invented performance claims about formats or hooks.

    line 121

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Talking Head

Turn a message and an audience into a complete Talking Head Video Spec — one presenter archetype fully specified (styling, setting, lighting, framing), a timed hook/body/CTA script skeleton, and keyframe prompts ready for fal-ai/nano-banana-pro. The governing principle: credibility is cast, not scripted — the presenter's look, setting, and register must match what the audience already trusts for this kind of message (a polished studio expert selling "authentic user review" reads as an ad and dies). You produce the plan and still keyframes; voice, motion, and editing happen downstream.

When to use / when not to

  • Use for any video fronted by a person: testimonials, UGC-style ads, educational/explainer videos, founder updates, product demos with a presenter, corporate training.
  • Product-only motion (no person) → skills/creative/product-video.
  • Programmatic/animated videos rendered in Remotion → skills/creative/remotion-script-writer.
  • Static social assets → skills/creative/social-graphics.
  • No brand style defined and consistency matters → run skills/creative/creative-strategist first; its style guide feeds presenter styling.

Intake

Ask in one tight batch, only what's missing:

  1. Message and goal — what is the presenter saying, and what should the viewer do after (CTA)?
  2. Audience and platform — who watches, and where (TikTok/Reels, YouTube, landing page, internal training)?
  3. Trust mode — should this feel like a peer's recommendation (authentic/UGC) or an expert's word (authority/polished)?
  4. Constraints — real person to feature (founder, customer) or generated/hired presenter? Brand style guide from skills/creative/creative-strategist?

Infer instead of asking: platform → length and framing; product category → default trust mode (consumer social ad → UGC; B2B/finance/health → authority). Don't stall: with message + audience known, state assumptions ("Assuming UGC style, 30s, vertical — say otherwise") and proceed.

Workflow

1. Cast the presenter (decision rule)

If the content is…ArchetypeRegisterDefault setting
Educational, corporate, product demoProfessional Presenterpolished, business casual/formal, direct eye contact, confidentstudio or professional office
Testimonial, social ad, relatable pitchUGC Creatorcasual clothes, natural look, authentic energy, imperfect is goodhome, car, casual real-world spot
Thought leadership, reviews, authority claimsExpert / Influencerpolished but approachable, credible, high productionprofessional office or branded studio
Lifestyle content, product-in-life, aspirationalLifestyle Creatorstylish, aspirational, engaginglifestyle location matching the product

Commit to one archetype with a one-line reason. Mismatches to catch: authority archetype for a "real customer" message (reads fake); UGC archetype for high-stakes B2B claims (reads unserious).

2. Lock the look — one choice per row

DimensionOptions (pick one, driven by archetype + brand)
Clothingbusiness professional (suit) · business casual (blazer) · casual · stylish casual · industry-specific attire
Backgroundstudio (neutral, clean) · office (blurred, modern) · home office · lifestyle setting · branded (brand colors/elements)
Lightingstudio (key + fill, even, no harsh shadows) · natural (soft, diffused, warm) · cinematic (dramatic, moody)
Framingclose-up (head/shoulders — intimacy, hooks) · medium (head-to-waist — default, allows gesture) · wide (full body — environment storytelling)

Decision rules: UGC → casual clothing + natural lighting + close-up/handheld feel. Authority → business casual + studio lighting + medium shot. Clothing must contrast with the background color. Vertical platforms default to close-up or tight medium; landscape/YouTube tolerates medium and wide.

3. Write the script skeleton with hard timing

  • Hook (0–3s): open with the viewer's problem, a bold claim, or the result — never "Hi, I'm…" on social. One sentence, ≤15 words.
  • Body (3s → CTA): one core message, max 3 supporting points, spoken language (read it aloud — if a sentence can't be said in one breath, split it). Product shown on camera if relevant.
  • CTA (final 5s): one action, stated once, plainly.

Length by platform: social ads/organic 15–60s; landing page 30–90s; training as needed. ~2.5 words/second is a workable speaking-pace heuristic for timing the script.

4. Write keyframe prompts

One keyframe per script section (hook, each body beat, CTA). Prompt formula: [archetype] presenter, [clothing], [appearance/expression for this beat], [engaging with camera / demonstrating product], [background], [lighting], [framing], professional quality, 4K. Keep presenter description, background, and lighting identical across all frames — only expression, gesture, and any product prop change; drift here breaks the illusion of one continuous video.

If FAL_API_KEY (or FAL_KEY) is set, generate via the repo CLI (docs/fal_api.py, model fal-ai/nano-banana-pro):

python docs/creative_cli.py custom \
  --category "talking-head" --name "hook-frame" \
  --prompt "<keyframe prompt>" --aspect-ratio 9:16 --resolution 2K

Otherwise deliver prompts as ready-to-run commands. Note: this produces still frames for casting/storyboarding — voice, lip-sync, and motion come from downstream tools or a real shoot; audio quality is out of scope but flag to the user that it makes or breaks the video.

5. Self-check against the quality bar, deliver the spec.

Required output format

Always deliver this structure:

# Talking Head Video Spec — [Topic]

## Overview
- **Message (one sentence):** ...
- **Archetype:** Professional | UGC Creator | Expert | Lifestyle — [one-line reason]
- **Platform:** ... · **Aspect ratio:** ... · **Length:** ...s · **CTA:** ...

## Presenter definition
- Clothing: ... · Appearance: ... · Background: ... · Lighting: ... · Framing: ...
- Real person or generated: ... · Brand elements in frame: ...

## Script skeleton
| Section | Time | Spoken line(s) | On camera |
|---|---|---|---|
| Hook | 0–3s | "..." (≤15 words) | [expression/action] |
| Body 1 | 3–Xs | "..." | ... |
| Body 2 | ... | "..." | ... |
| CTA | last 5s | "..." | ... |

## Keyframes
### KF-hook
> [full prompt — archetype, clothing, expression, background, lighting, framing, quality tags]
`python docs/creative_cli.py custom --category "talking-head" --name "kf-hook" --prompt "..." --aspect-ratio [x] --resolution 2K`
(one per section; presenter/background/lighting identical across all)

## Production notes
- Audio: [clean VO essential; mic/recording note]
- Downstream: [real shoot / avatar tool / editor] · B-roll or product inserts: ...

Quality bar (check before delivering)

  • Archetype matches the trust mode — no polished studio look on a "real customer" testimonial, no sloppy UGC for high-stakes authority claims.
  • Hook ≤15 words and contains no self-introduction (for social); value stated in the first 3 seconds.
  • One core message, ≤3 supporting points; every line survives being read aloud.
  • Clothing contrasts with background; lighting style named explicitly (never left implicit).
  • Keyframe prompts share identical presenter, background, and lighting descriptors — only expression/gesture varies.
  • Direct eye contact specified in every keyframe unless the beat deliberately breaks it.
  • Timings sum to the stated length; CTA is one action, stated once.
  • No invented performance claims about formats or hooks; pacing guidance is heuristic.

Integration

  • skills/creative/creative-strategist → feeds in: style guide governing presenter styling, palette, and setting.
  • skills/creative/original-design → feeds in: a design-language brief when the video must live inside an original visual world (backgrounds, props, overlays).
  • skills/creative/brand-asset → feeds in: logos/brand elements placed in the background or as overlays.
  • skills/creative/image-generation → consumes: keyframe prompts when the user wants finer generation control than the CLI one-liners.
  • skills/creative/social-graphics → consumes: keyframes as thumbnails and supporting post visuals.
  • skills/creative/orchestrator → routes campaign work that includes presenter video through this skill.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.