CommunityWriting & Editinggithub.com

hessa-script

Write a video script for any creator and any topic (Short/Reel, 5-min, 10-min or custom) with the H.E.S.S.A formula, timestamps, pause/emphasis marks and on-screen cues. Use for any video or content script request.

What is hessa-script?

hessa-script is a Claude Code agent skill that write a video script for any creator and any topic (Short/Reel, 5-min, 10-min or custom) with the H.E.S.S.A formula, timestamps, pause/emphasis marks and on-screen cues. Use for any video or content script request.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/robin3317/hessa-script/tree/HEAD/skills/hessa-script

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

H.E.S.S.A Script Writer (দর্শক ধরে রাখার স্ক্রিপ্ট ফর্মুলা)

Write spoken video scripts that hold viewers from the first second to the CTA. It works for any creator (talking-head, faceless or voice-over), any platform (YouTube, Shorts, Reels, TikTok, Facebook) and any topic: tech, education, news, health, finance, business, motivation, stories, reviews, how-to, food, travel, religion, lifestyle.

Every script follows the same guideline:

  • the inputs
  • the 4 pre-writing questions
  • H.E.S.S.A, adapted to the topic type
  • timing
  • ingredient tiers
  • writing rules
  • on-screen cues
  • the final checklist

0. Inputs

Take what the request gives. For anything missing, use the default and state each assumption in one line at the top of the output. Ask only when the topic itself is missing; then offer 3 topic ideas in the creator's niche.

InputDefault
Topic(required)
Format / lengthShort or Reel, 90 seconds
PlatformShort-form (YouTube Shorts / Reels / TikTok)
LanguageThe language of the request; Bengali if the request is in Bengali
AudienceGeneral viewers new to the topic
ToneMatched to the topic: educational, news, story, motivational, review, humorous
Creator / channel nameNone; the CTA stays generic
CTAA follow/subscribe line in the script's language, naming the channel if given

CTA rules:

  • Use the platform's own verb: YouTube = Subscribe, Facebook/Instagram/TikTok = Follow.
  • If one video goes to several platforms, one line covers all of them. Example: "আর এরকম ভিডিও পেতে Facebook-এ হলে Follow করুন, আর YouTube-এ Subscribe করুন [চ্যানেলের নাম]।"
  • If the creator gives their own CTA line, use it word for word.

1. Research first (whenever the script states facts)

  • Search the web and open the primary source: official site, report, study, government page, company blog, docs. A search snippet is not a source.
  • Prefer the most recent information. Note the publication date.
  • Every number must match its source exactly. Round only when speaking ("প্রায় ১৪%") and keep the exact figure in the on-screen cue.
  • If a source's advice is meant for a different audience (countries, companies, doctors), say so in the source note when adapting it.
  • Never invent facts, quotes, statistics or the creator's personal experiences. Where a personal story belongs, leave a placeholder: [আপনার নিজের অভিজ্ঞতা: …].
  • Sensitive topics (health, medicine, finance, investing, law, religion, politics):
    • use only authoritative sources
    • present information, not personal medical, financial or legal advice
    • add one short on-screen or spoken line such as "আপনার ক্ষেত্রে বিশেষজ্ঞের পরামর্শ নিন"
    • stay balanced on contested political or religious questions
  • Pure opinion, story or comedy scripts need no research, but any fact inside them still does.

2. Answer the 4 pre-writing questions (one line each)

Don't start writing until all four have an answer:

  1. Who is the viewer? Age, background, knowledge level.
  2. What do they want? The problem, question or feeling they came for.
  3. What will they doubt? The objection they'll raise; answer it inside the script.
  4. What is the one message? The single sentence they should remember.

3. Structure: H.E.S.S.A

Always in this order:

  1. Hook: Touch the viewer's own problem, curiosity or emotion. Use exactly ONE hook type. The first line gets straight to the point, with no greeting or self-introduction.
  2. Explain: What it is and why it matters. Maximum 3 key points.
  3. Solution: What to do or take away, as concrete, doable steps or a clear lesson.
  4. Summary: The key points, one sentence each. Nothing new. In Shorts, just the one-message line.
  5. Action + CTA: ONE specific action with a time frame ("আজ রাতে একবার করে দেখুন", not "চেষ্টা করতে থাকুন"), then the CTA.

Adapting H.E.S.S.A to the topic type

Topic typeExplain becomesSolution becomes
How-to / tutorial / recipeShort: what you'll make and why it worksLong: numbered steps, with the common mistake to avoid
News / updateWhat happened, and why it matters to the viewerWhat it means for them and what to do now
Story / motivationThe story: situation, struggle, turning pointThe lesson and how to apply it
Review / comparisonWhat it is, and key facts or specs that matterVerdict: who it's for, who should skip it
Explainer / educationThe concept, built from simple to complex with an analogyHow to use or remember it
Opinion / commentaryThe claim and the evidence for itThe fair counterpoint, then the takeaway
Myth vs factThe myth and why people believe itThe fact, with source, and what to do instead

Hook types (pick one)

TypePattern (Bengali example)
Belief-flip question"ভাবছেন X? // আসলে — উল্টো।"
Shocking number"১০০ জনের মধ্যে মাত্র ৪ জন এটা জানে।"
Common mistake"বেশিরভাগ মানুষ এই ভুলটা প্রতিদিন করে।"
Before / after"আগে ২ ঘণ্টা লাগত, এখন লাগে ৫ মিনিট।"
Direct promise"৯০ সেকেন্ডে শিখে নিন…"
Story opener"২০১৯ সালের এক রাতে সব কিছু বদলে গেল…"

The hook must deliver on the video's title and thumbnail promise. Never write a clickbait hook the script doesn't pay off.

Re-hooks

  • Short: one re-hook around 0:20, a pivot line such as "কিন্তু আসল কথাটা…" or "এখানেই সবচেয়ে বড় ভুলটা হয়…".
  • Longer videos: a re-hook or open loop ("শেষে একটা টিপস দেব যেটা…") every 1–2 minutes.

4. Timing

PartShort (90 seconds)Medium (5 minutes)Long (10 minutes)Any other length
Hook3 seconds30 seconds1 minute~10% (Shorts: first 3 seconds)
Explain40 seconds2 minutes 15 seconds4.5 minutes~45%
Solution30 seconds1 minute 15 seconds2.5 minutes~25–33%
Summary7 seconds15 seconds30 seconds~5%
Action + CTA10 seconds15 seconds30 seconds~5–10%
Buffer—30 seconds1 minute~10% (not in Shorts)
  • Explain + Solution take 70% or more of the time.
  • For a how-to or recipe, shift time from Explain to Solution.
  • Size the script by speaking rate: Bengali ~2–2.5 words/second (90 seconds ≈ 190–220 words), English ~2.3–2.7 words/second (90 seconds ≈ 210–240 words).
  • Tell the creator to time one read-aloud with a stopwatch.

5. Choosing ingredients (tiers)

  • Must have, every script: topic, objective, one story or example, one practical lesson, one action.
  • 1–2 per key point: example, analogy, fact/research, or real experience.
  • Use sparingly: quote (max 1 per script, correctly attributed), question (as hook or to make viewers think).
  • Longer videos only: viewer participation (comment prompt, small challenge, poll).

6. Writing rules (write for speaking, not reading)

  • Conversational: write the way you'd explain it to a friend, in the request's language. Common English terms the audience already uses stay in English.
  • Respectful address: in Bengali always আপনি / আপনার, never তুমি / তোমার / তুই, unless the creator explicitly asks for an informal style. In other languages, use the polite or neutral form.
  • Short sentences: one breath, one idea.
  • Explain jargon in one line the first time it appears.
  • Pause marks: / = short pause, // = Power Pause (1–2 seconds), placed before the key line.
  • Emphasis: bold exactly one word or phrase per sentence, the word to stress.
  • Transitions: a short bridge between parts, e.g. "তাহলে উপায় কী?"
  • Strong finish: the last line is fixed in advance and must not trail off.
  • Fair and kind: no stereotypes, insults or fear-mongering to drive views.

7. On-screen cues

For every row, give one concrete visual cue that works for any editing setup (CapCut, Premiere, Canva, motion-graphics tools, or plain talking-head):

  • big text, with the exact words
  • a chart, with its exact numbers and labels
  • steps (A → B → C)
  • B-roll or a cutaway (describe the shot)
  • a quote card
  • an icon or emoji sticker
  • the creator on camera with a gesture
  • Follow / Subscribe buttons

Reveal numbers in sync with when they're spoken.

8. Output format

Write in the request's language. Deliver in this order:

  1. Header:
    • title idea
    • format and target length
    • one message (one line)
    • audience (one line)
    • assumptions made
  2. Script table:
সময়অংশযা বলবেনস্ক্রিনে
০:০০–০:০৩Hook… with /, // and bold…
  • Use the request's language for column names and digits (Bengali digits in Bengali scripts).
  • Mark the re-hook row as "Explain (Re-hook)".
  1. Sources: linked list of pages actually opened, with dates; a note if advice was adapted. Leave this out if the script has no facts.
  2. Checklist result: the 8 checks below, each ✅ or with the fix applied.

9. Final checklist (run before delivering, fix anything that fails)

  1. Will the first 3 seconds stop the scroll?
  2. Can the one message be said in one sentence?
  3. No more than 3 key points?
  4. Does Solution give concrete, doable steps or a clear lesson?
  5. Is every fact verified against an opened source, with nothing invented?
  6. Does the read-aloud estimate fit the target length?
  7. Can any line be cut without loss? If yes, cut it.
  8. Does it end with one specific action plus the correct CTA?

Example (abridged)

Topic: World Bank WDR 2026 on AI and jobs · News · Short, 90 seconds · Bengali · no channel name given.

সময়অংশযা বলবেনস্ক্রিনে
০:০০–০:০৩HookAI আপনার চাকরি খেয়ে ফেলবে? // World Bank বলছে — উল্টো।"AI = চাকরি শেষ?" → কাটা দাগ
০:০৩–০:২০Explainধনী দেশে প্রায় ১৪% চাকরি ঝুঁকিতে। / আমাদের মতো দেশে? মাত্র সাড়ে ৪%।বার চার্ট: ১৪.২% বনাম ৪.৫%
০:২০–০:৪৩Explain (Re-hook)কিন্তু আসল খবর দ্বিতীয় সংখ্যায়…বার চার্ট: ১৬.২% বনাম ১৮.৭%
০:৪৩–১:১৩Solutionএক — Adopt … দুই — Adapt … তিন — Advance …Adopt → Adapt → Advance সিঁড়ি
১:১৩–১:২০Summaryমনে রাখুন: // AI চাকরি নেবে না, AI জানা মানুষ চাকরি নেবে।কোট কার্ড
১:২০–১:৩০Action + CTAআজ একটা কাজ AI দিয়ে করে দেখুন… / আর এরকম ভিডিও পেতে Follow করুন।Follow বাটন

Related Skills