VIRALSCRIPT HANDBOOK
How ViralScript works
ViralScript is an AI script generator built for Indian creators. You give it a topic. It gives you a complete, ready-to-film script in your language — with a story structure, hook, filming plan, and a predicted view range.
Every script goes through 8 AI agents working in sequence. Each one specialises in a single job. The result is not a templated output — it is a script built from the inside out, calibrated to your niche, your language, and what India is paying attention to right now.
THE ENGINE
The 8 agents — who does what
0
Pre-thinkSonnet
Builds the 5-line skeleton, designs the oven moment, engineers 5 hooks before writing begins.
1
Niche intelligence
Pulls what is working in your specific niche — top hooks, structural patterns, and emotional triggers.
2
Hook engineering
Tests 6 hook types and selects the strongest one for your topic, niche, and language.
3
Platform structure
Maps timing and pacing for your chosen platform — Instagram, YouTube Shorts, long-form, or LinkedIn.
4
Cultural DNA
Injects live Indian city and emotion context — what is actually happening in India this week.
5
Emotion arc
Designs the feeling journey: the opening tension, the build, the resolution, and the post-watch emotion.
6
Script writerSonnet
Writes 3 complete versions at different boldness levels using all prior context.
7
Critic
Scores against 11 dimensions. Rejects anything below 76/100 and flags exactly what to improve.
THE FRAMEWORK
The 12 creativity laws
Every script is evaluated against these 12 laws. Agent 7 scores each one from 0–10. A script only passes if it scores above 76/100 in aggregate.
1.
Aha Moment
Push 10% past the obvious insight — to the thing the audience almost knew but hadn't put into words.
2.
Specificity
₹847 not "a lot of money". Marathahalli not "Bangalore". Specificity creates credibility.
3.
Cognitive Open Loop
6 types of curiosity gaps — information, prediction, resolution, identity, social, and empathy.
4.
Precision Vulnerability
One real specific moment, not performed emotion. The crack in the voice, not the speech.
5.
Combinatory Play
Unexpected connections between your niche and something outside it. Finance + cricket. Fitness + mythology.
6.
Contradiction Engine
Write from inside the tension, not from resolution. The audience stays because you haven't resolved it yet.
7.
The Enemy
Name the belief system the script opposes. Not a person — a commonly held assumption.
8.
Sensory Bypass
One physical detail at the emotional peak. Sound, texture, temperature. Bypasses rational filtering.
9.
Inevitable Surprise
Plant a clue early that the audience doesn't recognise as a clue. Deliver it late.
10.
Controlled Imperfection
One genuine admitted flaw. Perfection feels curated. Imperfection feels honest.
11.
Oven Moment
Design the visual payoff first, then work backwards to the hook. What does the viewer see at the end?
12.
B-Plot
Two simultaneous curiosities running through the script. The viewer is tracking two threads at once.
CREATIVITY MODES
What each mode does
Safe
Proven structure, low risk, consistent performance. Best when you know your audience deeply.
All
Balanced
Safe foundation with one unexpected angle. A twist the audience didn't see coming but immediately accepts.
All
Bold
Pushes harder. Challenges audience assumptions. May polarise — and that is the point.
Creator+
Wildcard
Unexpected framing, high variance, high upside. This is the mode that produces the outlier scripts.
Pro+
Authority
Optimised for customer conversion, not views. Built for creators who sell a product or service.
Pro/Agency
BEST PRACTICE
How to get the best results
→Be specific with your topic. "How I paid off ₹3L debt in 8 months" beats "debt tips".
→Choose your actual city — the system uses it for cultural calibration.
→Start with Balanced, not Safe. Safe is for when you know your audience deeply.
→Generate 3 versions and combine the best lines from each.
→Film within 24 hours of generating — the cultural pulse data is live.
→Enter your actual views after posting — the prediction system learns from real data.
→After 5 scripts posted, your Performance DNA activates and scripts become personal.
PRODUCTION BRIEF
What the production brief tells you
Shot typeClose-up, wide, or talking head direction for each line of the script.
Text overlaysExact on-screen text suggestions with timing.
Facial expressionDirection for the emotion to hold at each moment.
TimingTarget seconds per line for your chosen platform.
B-rollSpecific cutaway suggestions for each section.
LANGUAGES
Languages and what each means
HindiPure formal Hindi — Doordarshan register. Best for educational and information-dense content.
HinglishNatural code-switching — how real creators talk. The default language of Indian social media.
TamilCalibrated to Tamil Nadu cultural signals, references, and emotional register.
TeluguCalibrated to Andhra + Telangana audiences, culture, and current events.
PunjabiPunjab + diaspora energy. Works for both domestic and international Punjabi audiences.
MarathiMaharashtra specific — Mumbai, Pune, and regional cultural context.
English (India)Indian English — not American or British. The way educated urban Indians actually write.
English (UK/USA)For diaspora-targeting content. Calibrated to NRI audiences in the UK and US.
PRIVACY + DATA
What we do and don't do with your data
✓Camera analysis runs entirely on your device. Video is never uploaded to our servers.
✓Scripts are stored privately in your account — only you can see them.
✓We do not sell your data to any third party.
✓We do not train our AI models on your scripts or your content.