@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/educational-explainer.md

@@ -0,0 +1,129 @@
+# Educational Explainer — Format
+
+> Quick education on a topic. 30-90s. Visual learning. Numbered or step-by-step.
+
+## Format basics
+
+- Length: 30-90 seconds
+- Aspect: 9:16 vertical
+- Teaches something
+- Visual demonstrations
+- Often numbered or step-by-step
+
+## Structure
+
+```
+0-3s    HOOK
+        "Here's how to..." / "Did you know..."
+        Promise of learning
+
+3-15s   SETUP
+        Why this matters
+        Common confusion
+
+15-50s  TEACHING
+        Numbered steps OR
+        Single concept explained
+        Visual demonstrations
+
+50-60s  RESULT / CTA
+        Demonstrate working
+        Save / share / follow
+```
+
+## Sample 60s educational
+
+```
+"How to taste coffee like a barista (in 3 steps)"
+
+0-3s: HOOK
+Hands smelling coffee.
+Text: "How to taste coffee like a barista"
+
+3-10s: SETUP
+"Most people drink coffee. Few people TASTE it."
+"Here's the 3-step method baristas use."
+
+10-25s: STEP 1
+Text: "STEP 1: Smell"
+Demonstration: holding cup near nose, eyes closed.
+"Inhale slowly. Notice: floral? Earthy? Fruit?"
+
+25-40s: STEP 2
+Text: "STEP 2: Slurp loudly"
+Demonstration (yes, audibly slurps).
+"Slurp it. The air mixes with coffee, releases more flavor."
+
+40-50s: STEP 3
+Text: "STEP 3: Identify ONE thing"
+Demonstration: thinking face.
+"Don't try to find ten flavors. Find ONE specific note."
+
+50-60s: PAYOFF
+"Today my coffee tastes like dark chocolate and cherries.
+What does yours taste like?"
+CTA: "Tag a coffee lover who needs this."
+```
+
+## Key principles
+
+### Clear value promise
+First 3 seconds: what will I learn?
+
+### Visual demonstrations
+Show, don't just tell. Visuals reinforce.
+
+### Numbered or structured
+Easy to follow, easy to remember.
+
+### Test it yourself prompt
+Audience can try immediately.
+
+### Save-worthy
+Make people want to bookmark.
+
+## Sub-types
+
+### Tutorial
+- How to DO something
+- Steps required
+
+### Concept explainer
+- What IS this?
+- Quick understanding
+
+### Myth-buster
+- "Actually, ___ is wrong"
+- Correction-based
+
+### Comparison
+- A vs B
+- Which is better?
+
+### History / context
+- Where did ___ come from?
+- Brief lesson
+
+## When to use
+
+- Building authority
+- Audience growth (saves boost algorithm)
+- Brand education
+- Personal expertise share
+- High-engagement content
+
+## Common mistakes
+
+- Too dense (information overload)
+- No visual demonstration
+- Generic content
+- Slow opening
+- Forgetting CTA
+
+## Production for educational
+
+- Clean visuals (not cluttered)
+- Big readable text
+- Clear voice (no music drowning)
+- Demonstration shots
+- Final result visible

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/hook-resolve.md

@@ -0,0 +1,123 @@
+# Hook-Resolve — Format
+
+> Question/claim setup → answer/reveal payoff. Curiosity-driven. 15-60s.
+
+## Format basics
+
+- Length: 15-60 seconds
+- Aspect: 9:16 vertical
+- Question planted in hook
+- Audience must watch for answer
+- Single-purpose structure
+
+## Structure
+
+```
+0-3s    HOOK / QUESTION
+        Bold claim or curiosity
+        "You won't believe..."
+        "Here's why..."
+
+3-30s   SETUP / TENSION
+        Build the question
+        Provide context
+
+30-50s  REVEAL
+        Answer the question
+        Pay off the curiosity
+
+50-60s  CTA / FINAL
+        Follow / next video
+        Memorable close
+```
+
+## Sample 45s hook-resolve
+
+```
+"Why your coffee tastes burnt (and it's not the beans)"
+
+0-3s: HOOK
+Question on screen: "Why your coffee tastes burnt"
+Subtitle: "(and it's not the beans)"
+Visual: bitter-faced reaction
+
+3-10s: SETUP
+"Most people blame their beans when coffee tastes bad. But there's
+one thing you're doing that ruins even premium beans."
+
+10-25s: TENSION BUILD
+"It's not the grind size. It's not the water temperature. It's not
+even the brewing method."
+
+(Visual: each negation flashes on screen with "X" mark)
+
+25-40s: REVEAL
+"It's your equipment. Specifically: your machine isn't clean."
+Visual: tearing apart espresso machine, showing buildup.
+"Coffee oils build up in machines. Old oils + heat = burnt taste.
+Even with fresh beans."
+
+40-55s: SOLUTION
+"Clean your machine weekly. Vinegar + water cycle works for most."
+Visual: cleaning demonstration.
+
+55-60s: CTA
+"Save this for your next coffee morning. Follow for more home barista tips."
+```
+
+## Key principles
+
+### Strong question hook
+- Curiosity gap
+- Common pain point
+- Surprising claim
+
+### Withhold the answer
+- Build tension throughout middle
+- Don't reveal too early
+- Audience must watch to end
+
+### Single payoff
+- One clear answer
+- Don't multiply mysteries
+- Satisfying reveal
+
+### Educational value
+- Teach something
+- Solve a problem
+- Useful information
+
+## Hook templates
+
+- "Why ___ doesn't work"
+- "The reason ___ happens"
+- "How to actually ___"
+- "What ___ doesn't tell you"
+- "The truth about ___"
+- "Stop doing ___ (do this instead)"
+
+## When to use
+
+- Educational content
+- Solving common problems
+- Myth-busting
+- Tips / hacks
+- Building authority on subject
+
+## Common mistakes
+
+- Weak question (no real curiosity)
+- Reveal too early
+- Disappointing answer (over-promise)
+- No teaching value
+- Generic hook
+
+## Hook quality test
+
+Ask: would I stop scrolling if I saw this?
+
+Hook must feel:
+- Surprising
+- Personally relevant
+- Specific (not generic)
+- Promising real value

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/mini-vlog.md

@@ -0,0 +1,118 @@
+# Mini Vlog — Format
+
+> Short vlog. 30-90s slice of life. Casual, personal.
+
+## Format basics
+
+- Length: 30-90 seconds
+- Aspect: 9:16 vertical
+- Day-in-life or moment captures
+- Casual aesthetic
+- Multiple short clips
+
+## Structure
+
+```
+0-3s    HOOK
+        Something interesting happens
+        Or "come with me to..."
+
+3-50s   VIGNETTES
+        Series of moments
+        Quick cuts
+        Soundtrack-driven
+
+50-60s  REFLECTION / CLOSE
+        Summing up
+        Moment of stillness
+        CTA optional
+```
+
+## Sample 60s mini vlog
+
+```
+"A Saturday morning at my coffee shop"
+
+0-3s: HOOK
+Drone shot above coffee shop, sun rising.
+Text: "Saturday morning at my coffee shop"
+
+3-15s: OPENING
+Walking to shop in dawn light. Coffee in hand.
+Unlocking the shop.
+Music: chill instrumental begins.
+
+15-30s: MORNING SETUP
+Quick cuts:
+- Grinder buzzing
+- Espresso machine warming
+- Wiping down counters
+- First customer arriving
+
+30-45s: BUSY HOUR
+Customers coming and going.
+Making drinks at speed.
+Smiles.
+Latte art shots (quick).
+
+45-55s: QUIET MOMENT
+Brief lull. Looking out window.
+Sipping own coffee.
+Sunlight through window.
+
+55-60s: REFLECTION
+Voice: "Saturdays are everything."
+Final shot: quiet moment with coffee.
+Text: "follow for daily shop life"
+```
+
+## Key principles
+
+### Real moments
+Not staged. Capture what actually happens.
+
+### Visual variety
+Many short clips, not one long one.
+
+### Soundtrack
+Music carries energy. Match to mood.
+
+### Personal connection
+Audience feels like they're with you.
+
+### No pressure
+Doesn't have to teach, sell, or make point. Just BE there.
+
+## Sub-types
+
+### Day-in-life
+Full day compressed
+
+### Specific event
+"Wedding day," "Concert," "Travel"
+
+### Routine
+"My morning routine"
+
+### Behind-the-scenes
+"Building my business"
+
+### Place-based
+"Sunset in Tokyo"
+
+## When to use
+
+- Brand humanizing
+- Creator personal connection
+- Building audience
+- Authentic content
+- Lower production effort
+- Daily content
+
+## Common mistakes
+
+- Too long single shots
+- Boring middle
+- No music
+- Forgetting hook
+- Too "produced" feel (vlogs benefit from authentic)

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/pov-narrative.md

@@ -0,0 +1,124 @@
+# POV Narrative — Format
+
+> "POV: you are ___" framing. Audience IDs as subject. 15-60s.
+
+## Format basics
+
+- Length: 15-60 seconds
+- Aspect: 9:16 vertical
+- Direct second-person framing
+- Audience becomes the character
+- Often immersive camera
+
+## Structure
+
+```
+0-3s    POV ESTABLISHMENT
+        "POV: you are..."
+        Visual matches premise
+
+3-30s   SCENE UNFOLDS
+        Audience experiences the moment
+        First-person perspective
+
+30-50s  PAYOFF
+        Twist, climax, or insight
+
+50-60s  CTA
+        Engagement prompt
+```
+
+## Sample 45s POV narrative
+
+```
+"POV: You're the only customer at a coffee shop in Baku at 6 AM"
+
+0-3s: POV ESTABLISHMENT
+Camera POV: walking into a quiet coffee shop. Empty.
+Text: "POV: You're the only customer at 6 AM"
+
+3-15s: SCENE
+POV: barista looks up, surprised.
+"Oh, good morning! What can I get you?"
+POV: looking at menu board.
+Voice (yours, internal): "I should try something different today."
+
+15-30s: INTERACTION
+POV: ordering.
+"A pour-over, please. The Atlas blend."
+Barista: "Excellent choice. Five minutes?"
+POV: nodding, finding seat by window.
+
+30-45s: MOMENT
+POV: looking out window. Empty Baku street. Pre-dawn light.
+Barista brings the coffee.
+POV: first sip. Eyes close briefly (filmed via reflection).
+Voice (internal): "Some mornings deserve to be alone."
+
+45-60s: REFLECTION + CTA
+POV: settling in with the coffee. Sunrise begins outside.
+Text: "Tag your favorite quiet morning spot."
+End on the cup.
+```
+
+## Key principles
+
+### "You" framing
+- Direct second-person
+- Audience IDs immediately
+- Strong premise
+
+### POV camera
+- First-person perspective
+- Hands visible occasionally
+- Reflections show "you"
+
+### Immersive
+- Audio matches POV
+- Sound design for presence
+- Voice = your internal monologue
+
+### Emotional anchor
+- Moment that resonates
+- Universal feeling through specific scene
+
+## Sub-types
+
+### POV everyday moment
+"POV: you're making coffee at 5 AM"
+
+### POV emotional
+"POV: you're remembering your grandfather"
+
+### POV humorous
+"POV: you've been waiting an hour for your friend"
+
+### POV aspirational
+"POV: you bought your dream apartment"
+
+### POV uncomfortable
+"POV: you're at the wrong wedding"
+
+## When to use
+
+- Empathy-building content
+- Mood/aesthetic content
+- Brand experience marketing
+- Travel content
+- Creator personal moments
+
+## Common mistakes
+
+- Premise unclear
+- Camera shaky/disorienting
+- Wrong voice POV (third-person breaks immersion)
+- Too long
+- No emotional payoff
+
+## Production tips
+
+- Use a chest harness or POV mount
+- Or selfie with face barely visible
+- Wide-angle for "first-person feel"
+- Audio mic on you (internal voice)
+- Soft lighting

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/reel-narrative.md

@@ -0,0 +1,100 @@
+# Reel Narrative — Format
+
+> Instagram Reel with story structure. 30-90s. Polished but personal.
+
+## Format basics
+
+- Length: 30-90 seconds
+- Aspect: 9:16 vertical
+- Polished aesthetic (Reel audience)
+- Story arc within format
+- Sound-on with music
+
+## Structure
+
+```
+0-3s    HOOK
+        Strong visual + question/promise
+
+3-15s   SETUP
+        Character or situation established
+        Stakes hinted
+
+15-45s  STORY
+        Conflict, journey, beats
+        Visual variety
+
+45-55s  PAYOFF
+        Resolution or insight
+        Emotional moment
+
+55-60s  CTA
+        Soft (link in bio, follow)
+```
+
+## Sample 60s reel narrative
+
+```
+"How I Started My Coffee Brand With $500"
+
+0-3s: HOOK
+Hands holding a Karavan coffee bag.
+Text overlay: "I started a coffee brand with $500. Here's how."
+
+3-15s: SETUP
+Quick cuts: kitchen counter at 2 AM, generic coffee containers,
+spreadsheet with budget numbers.
+Voiceover: "Two years ago I had no money and an obsession with
+single-origin beans."
+
+15-45s: STORY
+- First batch in apartment kitchen
+- Small Instagram launch (3 followers)
+- First customer (a friend)
+- Slow growth montage
+- Setting up first packaging
+- Quality matters more than budget
+
+45-55s: PAYOFF
+Pour-over of finished product. Beautiful slow-motion.
+Voiceover: "Today, Karavan ships to 12 countries."
+
+55-60s: CTA
+Text: "Link in bio for the story"
+Follow button graphic
+End on logo
+```
+
+## Key principles
+
+### Quality matters
+Reels expect higher polish than TikTok.
+
+### Story arc within 60s
+Beginning + middle + end.
+
+### Visual variety
+Multiple shots, locations, angles.
+
+### Music essential
+Trending sound or original score.
+
+### Captions throughout
+Accessibility + scroll-by viewers.
+
+## When to use
+
+- Brand storytelling
+- Personal journey share
+- Product launch context
+- Behind-the-scenes
+- Creator portfolio piece
+- Audience-building content
+
+## Common mistakes
+
+- Too slow opening
+- Lo-fi aesthetic (TikTok-like, but Reel audience expects more)
+- Forgetting CTA
+- Music too generic
+- Caption-less

package/templates/skills/screenwriter/knowledge/categories/short-form/formats/tiktok-skit.md

@@ -0,0 +1,130 @@
+# TikTok Skit — Format
+
+> Short comedy sketch on TikTok. 15-60s. Multiple characters often (one creator playing both).
+
+## Format basics
+
+- Length: 15-60 seconds
+- Aspect: 9:16 vertical
+- Comedy sketch structure
+- Often single creator playing multiple characters
+- Quick cuts between characters
+
+## Structure
+
+```
+0-3s    SETUP
+        Premise established quickly
+
+3-30s   CONFLICT
+        Characters clash
+        Comedy beats
+
+30-50s  ESCALATION
+        Things get worse / more absurd
+
+50-60s  PUNCHLINE
+        Twist or final laugh
+```
+
+## Sample 45s TikTok skit
+
+```
+"When you order coffee in three different cities"
+
+0-3s: SETUP
+Text: "Ordering coffee in three different cities"
+Quick cut compilation begins.
+
+3-15s: BAKU
+Creator as customer in Azerbaijani cafe.
+"Mənə bir orta kapuçino lütfən."
+Cut to creator as barista (different filter, hat):
+"Burda otur, getirim. Şəkər neçə qaşıq?"
+Creator (customer): "Bir."
+Creator (barista): "İki yaxşıdır."
+Creator (customer): "Bir."
+Creator (barista): (gives two anyway, smiles)
+
+15-30s: PARIS
+Creator as customer:
+"Bonjour, un cappuccino, s'il vous plait."
+Creator as French barista:
+(without looking up)
+"Pas avant 11h. C'est interdit après le petit déjeuner."
+Creator (customer):
+"... what?"
+Creator (barista):
+(throws up hands, walks away)
+
+30-45s: NEW YORK
+Creator as customer:
+"Hi, can I get a small cappuccino?"
+Creator as American barista (apron, name tag):
+"Sure! What's your name?"
+Creator (customer): "Eldar."
+Creator (barista, written wrong on cup):
+(shows cup with "ALDOR" written on it)
+
+45s: PUNCHLINE
+Final shot: Creator as customer in own kitchen with French press.
+Text: "Or just learn to make it yourself."
+End on CTA.
+```
+
+## Key principles
+
+### One creator multiple characters
+Common technique:
+- Different positioning in frame
+- Different costumes/filters
+- Quick cuts
+- Voice changes
+
+### Specific premise
+"When you ___" or "POV: ___"
+
+### Comedy escalation
+Each beat raises absurdity.
+
+### Cultural specificity
+Local references = more shareable for that audience.
+
+## Sub-types
+
+### Recurring character skits
+Same character across videos (creates fan engagement)
+
+### "When you" skits
+Premise of recognizable situation
+
+### Trend-based skit
+Skit using trending format/sound
+
+### Series skits
+Continuing storyline across videos
+
+## When to use
+
+- Comedy creator content
+- Brand humor
+- Cultural commentary
+- Character-driven content
+- Building audience
+
+## Common mistakes
+
+- Too long setup
+- Missed punchline
+- Generic characters
+- Inside jokes that don't land
+- Bad lighting (single creator productions)
+- No pay-off
+
+## Production tips for solo creator
+
+- Tripod essential
+- Same lighting throughout
+- Color-correct between cuts
+- Voice work matters
+- Edit tight (no dead air)