@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/screenwriter/knowledge/categories/film/genres/fantasy.md

@@ -0,0 +1,213 @@
+# Fantasy — Genre
+
+> Films set in worlds with magic, mythical creatures, or impossible elements treated as real.
+
+## Defining elements
+
+- Magical / impossible elements
+- World with internal rules
+- Often quest structure
+- Good vs evil (often)
+- Wonder + danger
+
+## Sub-genres
+
+| Sub-genre | Example |
+|-----------|---------|
+| High fantasy | Lord of the Rings | Epic, fictional world |
+| Urban fantasy | Pan's Labyrinth | Magic in real world |
+| Fairy tale | Pan's Labyrinth, Pinocchio | Folktale roots |
+| Sword & sorcery | Conan the Barbarian | Action + magic |
+| Magical realism | Pan's Labyrinth, Big Fish | Magic in mundane |
+| Dark fantasy | The Witcher, Pan's Labyrinth | Grim, mature |
+| YA fantasy | Harry Potter, Narnia | Coming-of-age |
+| Mythological | Clash of the Titans | Greek/Norse myth |
+
+## Structural conventions
+
+### Quest structure
+- Hero called
+- Mentor met
+- Journey begun
+- Trials passed
+- Climax confrontation
+- Return transformed
+
+(Hero's Journey - Joseph Campbell)
+
+### Magic system
+- Internal rules established
+- Costs to magic use
+- Limits known
+- Consistent throughout
+
+### Good vs Evil
+- Often clear (or subverted)
+- Stakes existential
+- Heroes earn their victories
+
+### World-building
+- Geography, culture, history
+- Show through detail
+- Don't info-dump
+
+## Voice / Style
+
+### Visual
+- Production design = world
+- Practical + VFX
+- Color palette per world
+- Costume crucial
+
+### Music
+- Often orchestral
+- Themes for characters/worlds
+- Memorable melodies
+
+### Dialogue
+- Varies by world tone
+- High fantasy = elevated
+- Modern fantasy = contemporary
+- Historical-feeling for past worlds
+
+## Fantasy mechanics
+
+### Magic costs
+- Best magic systems have limits
+- "Hard magic" — clearly defined rules
+- "Soft magic" — mysterious (Tolkien)
+- Audience must understand stakes
+
+### Hero's journey beats
+1. Ordinary world
+2. Call to adventure
+3. Refusal of call
+4. Meeting mentor
+5. Crossing threshold
+6. Tests, allies, enemies
+7. Approach to inmost cave
+8. Ordeal
+9. Reward
+10. Road back
+11. Resurrection
+12. Return with elixir
+
+(Adapt freely; not all needed)
+
+### Companion party
+- Hero + supporting characters
+- Each fills role (warrior, mage, rogue, etc.)
+- Internal dynamics
+- Some fall in journey
+
+### World rules / lore
+- Established gradually
+- Show through events
+- Internal logic crucial
+- Audience infers
+
+## Sample fantasy scene
+
+```
+EXT. FOREST EDGE - DAY
+
+ELDAR (16), small for his age, stands at the edge of a forest
+darker than any forest should be. His grandmother's pendant
+warm against his chest.
+
+GRANDMOTHER (V.O., from memory)
+The path is closed to those who fear it. But it opens to those
+who have lost what cannot be found.
+
+He grips the pendant. His mother died last winter.
+
+He steps forward.
+
+The forest doesn't move. The birds keep singing.
+
+He steps again.
+
+The pendant grows hot.
+
+A SOUND — like a great bell — from deep in the forest. Not a
+warning. An invitation.
+
+He walks in. The forest closes behind him.
+
+The light changes. The trees grow taller. Older.
+
+Through the branches, he sees something move. Larger than a man.
+Smaller than a horse. Antlered.
+
+It watches him.
+
+ELDAR (whispers)
+Are you what I'm looking for?
+
+The creature steps forward into a shaft of light. A WHITE STAG,
+impossibly old, eyes too intelligent.
+
+WHITE STAG (telepathic, in his mind)
+You are looking for what cannot be found.
+
+ELDAR
+Yes.
+
+WHITE STAG
+Then you must lose what you carry first.
+
+He reaches for the pendant. Hesitates.
+```
+
+This works through:
+- World rules established (lost = found)
+- Magic with cost
+- Specific imagery
+- Wonder + danger
+- Quest beginning
+
+## Common mistakes
+
+- Magic without cost (no stakes)
+- Generic fantasy world (Tolkien-derived)
+- Info-dump exposition
+- Inconsistent magic rules
+- Forgetting human stakes
+- Too many made-up names
+- Convenient power-ups
+
+## Best fantasy films reference
+
+- Pan's Labyrinth (dark, mature)
+- Lord of the Rings trilogy (epic)
+- Princess Mononoke (myth + ecology)
+- Big Fish (magical realism)
+- The Princess Bride (witty)
+- Spirited Away (Japanese)
+- The Green Knight (mythic)
+- Beasts of the Southern Wild (modern)
+
+## When to write fantasy
+
+- Epic ambition
+- Wonder + adventure
+- Younger audience (often)
+- Streaming or theatrical
+- Franchise potential
+- World-building joy
+
+## Production realities
+
+Fantasy ranges:
+- Magical realism: low budget possible
+- Urban fantasy: moderate
+- High fantasy: massive (Lord of the Rings)
+- Independent fantasy: focus on character/single concept
+
+## Combination with other genres
+
+- Fantasy + Adventure (most common)
+- Fantasy + Romance (Princess Bride)
+- Fantasy + Horror (Pan's Labyrinth)
+- Fantasy + Coming-of-age (Harry Potter)
+- Fantasy + War (Lord of the Rings)

package/templates/skills/screenwriter/knowledge/categories/film/genres/horror.md

@@ -0,0 +1,202 @@
+# Horror — Genre
+
+> Films designed to frighten. Dread, fear, terror as primary emotions.
+
+## Defining elements
+
+- Designed to frighten audience
+- Threat (supernatural or human)
+- Vulnerability of protagonist
+- Dread building
+- Catharsis through fear
+
+## Sub-genres
+
+| Sub-genre | Example | Style |
+|-----------|---------|-------|
+| Supernatural | The Exorcist | Otherworldly threat |
+| Slasher | Halloween | Killer + victims |
+| Psychological | Hereditary | Mind unravels |
+| Folk horror | Midsommar | Cult/ritual |
+| Body horror | The Fly | Physical transformation |
+| Found footage | Paranormal Activity | First-person POV |
+| Creature feature | Alien | Monster threat |
+| Home invasion | The Strangers | Domestic terror |
+| Cosmic horror | The Lighthouse | Existential dread |
+| Religious horror | The Witch | Faith corrupted |
+| Zombie | 28 Days Later | Apocalyptic |
+
+## Structural conventions
+
+### Dread accumulation
+- Tension builds slowly
+- Discomfort accumulates
+- Pay off in moments
+
+### Scare beats / set pieces
+- Major scares spaced through runtime
+- Build to bigger ones
+- Mix types (jump, atmospheric, gore)
+
+### Vulnerable protagonist
+- Often isolated
+- Limited resources
+- Audience identifies fear
+
+### Resolution
+- Survival (final girl)
+- Tragic (everyone dies)
+- Pyrrhic (survives but changed)
+- Sequel hook (threat returns)
+
+## Voice / Style
+
+### Pacing
+- Slow build acceptable
+- Quiet before storm
+- Tension ratchets
+- Release moments brief
+
+### Visual
+- Darkness used well
+- What's NOT shown often scarier
+- Negative space
+- Reveal management
+
+### Sound design
+- Critical genre
+- Silence terrifying
+- Strings, drones
+- Sudden loud effective (used sparingly)
+
+### Dialogue
+- Less than other genres
+- Reaction over discussion
+- Whispers
+- Screams (earned)
+
+## Horror mechanics
+
+### Suspense
+- Audience knows danger
+- Character doesn't (yet)
+- Tension from anticipation
+
+### Dread
+- Wrongness in the world
+- Atmosphere off
+- Building unease
+
+### Jump scare
+- Misdirection + sudden
+- Use sparingly
+- Earned by buildup
+
+### Body horror
+- Transformation visible
+- Discomfort visceral
+- Implies fragility
+
+### Psychological
+- Reality questioned
+- Sanity slippage
+- Trust broken
+
+## Sample horror scene
+
+```
+INT. APARTMENT HALLWAY - NIGHT
+
+ELDAR (35) walks slowly down the hallway. He doesn't remember
+turning off the lights. The bedroom door is ajar — he closed it.
+
+A soft sound from inside. Something between breathing and whispering.
+
+He stops. Listens.
+
+The sound stops.
+
+Long beat. He almost turns to leave. Then —
+
+The bedroom door opens an inch wider. By itself. No wind.
+
+CLOSE ON ELDAR — frozen, eyes wide. He cannot move.
+
+The whispering starts again, louder now. From inside the room.
+It's saying his name.
+
+ELDAR (voice trembling)
+Hello?
+
+The whispering stops. The hallway is silent.
+
+Beat. He takes a tentative step forward.
+
+THE BEDROOM LIGHT FLICKS ON BY ITSELF.
+
+He sees a SHAPE in the room. Not human. Not quite.
+
+SMASH CUT TO BLACK.
+```
+
+This works through:
+- Slow build of wrongness
+- Sound design implied
+- What's NOT shown
+- Audience IDs with fear
+- Cliffhanger reveal
+
+## Common mistakes
+
+- Over-reliance on jump scares
+- Showing monster too early
+- Generic protagonist
+- No emotional core
+- Stupid character decisions ("don't go in there!")
+- Resolution that explains away
+- Cheap gore without impact
+
+## Best horror films reference
+
+- Hereditary (psychological)
+- The Witch (folk)
+- Get Out (social)
+- Midsommar (folk daylight)
+- A Quiet Place (sound)
+- The Babadook (grief)
+- It Follows (sexual metaphor)
+- Talk to Me (modern)
+
+## Sound design centrality
+
+Horror is 50% sound:
+- Score (often atonal strings)
+- Diegetic (creaks, breaths)
+- Silence (terrifying)
+- Sudden contrast (jump effective)
+
+## When to write horror
+
+- Genre-loving audience
+- Lower budget viable (great horror often cheap)
+- Festival circuit
+- Streaming success (Netflix loves horror)
+- Holiday timing (October release)
+
+## Combination with other genres
+
+- Horror + Comedy (Scream, Cabin in the Woods)
+- Horror + Drama (Hereditary)
+- Horror + Sci-fi (Alien)
+- Horror + Romance (rare, gothic)
+
+## Horror sub-elements that work
+
+- Children acting wrong
+- Animals knowing
+- Mirrors / reflections
+- Hidden compartments / spaces
+- Family secrets
+- Religious imagery
+- Isolation (cabin, snow, rural)
+- Unreliable senses

package/templates/skills/screenwriter/knowledge/categories/film/genres/magical-realism.md

@@ -0,0 +1,227 @@
+# Magical Realism — Genre
+
+> Films where magic exists in the everyday world, treated as ordinary. Distinguished from fantasy (which has separate magical worlds).
+
+## Defining elements
+
+- Magic / impossible elements present
+- Treated as normal by characters
+- World otherwise realistic
+- Cultural / spiritual roots often
+- Subtle vs. spectacular
+
+## Distinguished from related genres
+
+- **Magical realism** = magic in real world, treated as normal
+- **Fantasy** = magical world with rules
+- **Surreal** = dream-logic, often illogical
+- **Sci-fi** = speculative, technology-based
+
+In magical realism, a ghost is just a ghost — the family knows him, talks to him, has dinner with him. Not a horror element.
+
+## Sub-types
+
+| Sub-type | Example |
+|----------|---------|
+| Latin American tradition | Like Water for Chocolate, Pan's Labyrinth (semi) |
+| Whimsical | Big Fish, Amélie |
+| Spiritual | Beasts of the Southern Wild |
+| Family saga | One Hundred Years of Solitude (book) |
+| Childhood-perspective | Pan's Labyrinth |
+| Ghost as family | The Sixth Sense (mostly thriller, but ghost element) |
+| Nature-magic | The Tree of Life |
+
+## Structural conventions
+
+### Magic accepted
+- No explanation
+- Characters not surprised
+- Audience adapts
+- Magic just is
+
+### Realistic anchor
+- Setting recognizable
+- Most events realistic
+- Magic punctuates rather than dominates
+
+### Cultural / spiritual context
+- Often rooted in folk belief
+- Indigenous magic traditions
+- Religious / mystical
+- Latin American literature roots
+
+### Subtle integration
+- Not flashy
+- Often subtle visual
+- Audience accepts gradually
+
+## Voice / Style
+
+### Visual
+- Realistic + heightened moments
+- Color saturation often
+- Beautiful cinematography
+- Light used magically
+
+### Music
+- Atmospheric
+- Folk instruments often
+- Score builds wonder
+
+### Dialogue
+- Naturalistic
+- Magic referenced casually
+- Poetic moments
+- Cultural specificity
+
+## Magical realism mechanics
+
+### The threshold
+Audience enters magical realism when first impossible thing happens. Reaction:
+- Characters: unsurprised
+- Audience: re-orients
+
+After threshold, more magic accepted easily.
+
+### Symbolism
+- Magic = metaphor often
+- Grief becomes ghost
+- Love becomes ability
+- Memory becomes physical
+
+### Cultural rooting
+- Magic comes from culture
+- Folk tradition
+- Indigenous belief
+- Religious framework
+
+### Restraint
+- Less is more
+- Single magical element can carry film
+- Don't over-explain
+
+## Sample magical realism scene
+
+```
+INT. GRANDMOTHER'S HOUSE - DAY
+
+Three generations sit around a long table. The food is from a wedding
+that happened forty years ago. Everyone knows this. Nobody mentions it.
+
+The GRANDMOTHER (80) serves the soup. She doesn't have to ladle it
+— it pours itself when she holds the bowl up.
+
+GRANDMOTHER
+Eat. The soup remembers what we forgot.
+
+ELDAR (12) takes a sip. Closes his eyes.
+
+ELDAR
+I can taste it.
+
+GRANDMOTHER
+What can you taste?
+
+ELDAR
+The wedding.
+
+GRANDMOTHER
+Which one?
+
+ELDAR
+The one where you danced with the man who became my grandfather.
+
+GRANDMOTHER
+And what did the dance feel like?
+
+ELDAR
+Like rain that wasn't sad.
+
+The grandmother smiles. She continues serving. The soup keeps pouring
+itself.
+
+ELDAR'S MOTHER (40)
+Mother, leave the boy alone.
+
+GRANDMOTHER
+He understands. The understanding skips a generation.
+
+She pours soup for ELDAR'S MOTHER. The mother accepts. Tastes.
+
+MOTHER
+... I taste it too.
+
+GRANDMOTHER
+Good. The soup is generous today.
+
+She continues to the next bowl.
+```
+
+This works through:
+- Magic accepted (self-pouring soup)
+- Cultural context (memory, food, generation)
+- Symbolic meaning (soup = memory of love)
+- Naturalistic dialogue
+- Subtle wonder
+- Multi-generational
+
+## Common mistakes
+
+- Treating magic as fantasy (rules-heavy)
+- Treating magic as horror (fear-inducing)
+- Explaining the magic
+- Magic disconnected from theme
+- Generic Western fairy tale
+- Magic as plot device only
+- Inconsistent (sometimes accepted, sometimes shocking)
+
+## Best magical realism films reference
+
+### Latin American tradition
+- Like Water for Chocolate (1992)
+- Pan's Labyrinth (2006, hybrid)
+
+### Whimsical
+- Big Fish (Burton, 2003)
+- Amélie (Jeunet, 2001)
+- The Curious Case of Benjamin Button (2008)
+
+### Spiritual / serious
+- Beasts of the Southern Wild (2012)
+- The Tree of Life (Malick, 2011)
+- Wings of Desire (Wenders, 1987)
+
+### Modern
+- The Green Knight (Lowery, 2021)
+- Petite Maman (Sciamma, 2021)
+- The Florida Project (Baker, 2017, subtle)
+
+### Asian magical realism
+- Spirited Away (Miyazaki)
+- A Chinese Ghost Story
+- Past Lives (subtle magic of in-yun)
+
+## When to write magical realism
+
+- Cultural story
+- Family / generational
+- Spiritual / philosophical
+- Festival-friendly
+- Star vehicle (often)
+- Adaptation of novel
+
+## Production realities
+
+- Mostly realistic production
+- Magic moments may need VFX
+- Often achievable on indie budget
+- Practical effects preferred
+- Period accuracy if applicable
+
+## Combination
+
+- Magical realism + Drama (most common)
+- Magical realism + Family (Big Fish)
+- Magical realism + Romance (Amélie)
+- Magical realism + Coming-of-age (Pan's Labyrinth)
+- Magical realism + Folk horror (Pan's Labyrinth — hybrid)