tarot-content

name

tarot-content

description

Generate tarot × astrology content for social media — weekly horoscope scripts, tarot spreads, video scripts, and cover art. Use when asked to "create tarot content", "weekly horoscope", "tarot reading script", "zodiac video", "astrology content calendar", "tarot spread design", or "horoscope video script". Supports 12-sign weekly readings, event-driven specials (retrogrades, eclipses, conjunctions), and multi-platform formatting (YouTube Shorts, TikTok, Instagram, blog).

Tarot Content Generator

Create professional tarot × astrology content for social media at scale.

Capabilities

1. Weekly 12-Sign Readings — Scripted horoscope videos with tarot card pulls
2. Event-Driven Specials — Content for major transits (retrogrades, eclipses, conjunctions)
3. Tarot Spreads — Custom spread designs with interpretation frameworks
4. Video Scripts — TTS-ready scripts with screen text cues
5. Cover Art — Pillow-generated thumbnails optimized for mobile
6. Content Calendar — Automated scheduling based on astrological events

Quick Start

Weekly 12-Sign Reading

Generate a weekly tarot reading for all 12 signs.
Date range: {start} to {end}
Style: conversational, no jargon
Format: video script with screen text cues

The agent will:

1. Pull real ephemeris data (planetary positions, aspects)
2. Map transits to each sign's house system
3. Pull tarot cards (Challenge / Guidance / Blessing spread)
4. Write scripts in a natural, engaging voice

Event-Driven Special

Create a special video about {transit/event}.
Example: Saturn conjunct Neptune in Aries
Include: what it means, historical context, 12-sign breakdown

Content Framework

The 3-Card Spread (Challenge / Guidance / Blessing)

A proven framework for weekly readings:

Position	Meaning	Tone
Challenge	What to watch out for	Honest, not scary
Guidance	What to focus on	Actionable advice
Blessing	What's coming	Hopeful, encouraging

Script Structure (per sign, 60-90 seconds)

1. Opening hook (5s) — "Hey {Sign}, this week is about..."
2. Transit context (10s) — What planets are doing in their house
3. Card 1: Challenge (15s) — The obstacle + real-life scenario
4. Card 2: Guidance (15s) — Practical advice
5. Card 3: Blessing (10s) — The reward / positive outcome
6. CTA (5s) — "Follow for your sign's weekly reading"

Writing Style Guidelines

• Say it like a friend, not a fortune teller — "You might feel stuck" not "The cards reveal stagnation"
• Use scenarios — "That coworker drama? Time to set boundaries" not "Conflict in relationships"
• Numbers in words — "twenty twenty-six" not "2026" (TTS-friendly)
• Avoid fear-mongering — Even tough cards get a constructive spin
• No clichés — Ban "the universe has a plan", "trust the process", "everything happens for a reason"

Ephemeris Data

Using pyswisseph (recommended)

import swisseph as swe
from datetime import datetime

def get_planet_position(planet_id, dt):
    """Get planet longitude in zodiac."""
    jd = swe.julday(dt.year, dt.month, dt.day, dt.hour + dt.minute/60)
    pos = swe.calc_ut(jd, planet_id)[0]
    longitude = pos[0]
    sign_num = int(longitude / 30)
    degree = longitude % 30
    signs = ['Aries','Taurus','Gemini','Cancer','Leo','Virgo',
             'Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces']
    return signs[sign_num], degree

# Planet IDs: SUN=0, MOON=1, MERCURY=2, VENUS=3, MARS=4,
#             JUPITER=5, SATURN=6, URANUS=7, NEPTUNE=8, PLUTO=9

Install

pip install pyswisseph

Cover Art Generation

Pillow-based covers (no AI text artifacts)

from PIL import Image, ImageDraw, ImageFont
import os

def generate_cover(sign, hook_text, date_range, colors, output_path):
    """Generate a 1080x1920 Shorts cover."""
    W, H = 1080, 1920
    img = Image.new('RGB', (W, H))
    draw = ImageDraw.Draw(img)

    # Gradient background
    for y in range(H):
        r = int(colors[0][0] + (colors[1][0]-colors[0][0]) * y/H)
        g = int(colors[0][1] + (colors[1][1]-colors[0][1]) * y/H)
        b = int(colors[0][2] + (colors[1][2]-colors[0][2]) * y/H)
        draw.line([(0,y),(W,y)], fill=(r,g,b))

    # Load fonts (adjust paths for your system)
    font_lg = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 120)
    font_md = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 56)
    font_sm = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 40)

    # Sign name (large, centered)
    draw.text((W//2, H*0.35), sign.upper(), font=font_lg, fill='white', anchor=)

    
    draw.text((W//, H*), date_range, font=font_md, fill=(,,), anchor=)

    
    draw.text((W//, H*), hook_text, font=font_md, fill=, anchor=)

    
    draw.text((W//, H*), , font=font_sm, fill=(,,), anchor=)

    img.save(output_path, quality=)


SIGN_COLORS = {
    :       [(,,),  (,,)],
    :      [(,,),  (,,)],
    :      [(,,), (,,)],
    :      [(,,),(,,)],
    :         [(,,), (,,)],
    :       [(,,),  (,,)],
    :       [(,,),(,,)],
    :     [(,,),  (,,)],
    : [(,,), (,,)],
    :   [(,,),   (,,)],
    :    [(,,), (,,)],
    :      [(,,),(,,)],
}

Cover Rules

• ⚠️ Never use Unicode zodiac symbols (♈♉ etc.) — most fonts render them as ☒
• Use English sign names in large text instead
• Text must be readable at thumbnail size (phone screen)
• Keep important elements away from bottom 15% (YouTube UI overlay)

Content Calendar

Weekly Cycle

Day	Content	Platform
Mon	12 sign readings (video)	YouTube Shorts, TikTok
Wed	Mid-week energy check	Instagram Reel
Fri	Weekend tarot pull	TikTok, Shorts

Event-Driven (auto-detect from ephemeris)

• Mercury Retrograde → "Survival guide" series
• Full/New Moon → Moon ritual + tarot spread
• Eclipse season → "Eclipse portal" specials
• Major conjunctions → Deep-dive explainer + 12-sign impact

Sensitive Content Notes

Platform content policies vary. Avoid:

• Health/medical claims ("this card says you'll recover")
• Financial advice ("invest now, Jupiter says so")
• Fear-inducing predictions ("danger ahead", "death card means...")
• Always frame readings as reflection tools, not predictions