# Send Tarot Content to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tarot-content",
    "name": "Tarot Content",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/alexyuui/tarot-content",
    "canonicalUrl": "https://clawhub.ai/alexyuui/tarot-content",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/tarot-content",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tarot-content",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/tarot-cards.md",
      "scripts/ephemeris_helper.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "tarot-content",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T18:39:13.217Z",
      "expiresAt": "2026-05-07T18:39:13.217Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tarot-content",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tarot-content",
        "contentDisposition": "attachment; filename=\"tarot-content-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "tarot-content"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tarot-content"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tarot-content",
    "downloadUrl": "https://openagent3.xyz/downloads/tarot-content",
    "agentUrl": "https://openagent3.xyz/skills/tarot-content/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tarot-content/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tarot-content/agent.md"
  }
}
```
## Documentation

### Tarot Content Generator

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

### Capabilities

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

### 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:

Pull real ephemeris data (planetary positions, aspects)
Map transits to each sign's house system
Pull tarot cards (Challenge / Guidance / Blessing spread)
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

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

A proven framework for weekly readings:

PositionMeaningToneChallengeWhat to watch out forHonest, not scaryGuidanceWhat to focus onActionable adviceBlessingWhat's comingHopeful, 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"

### 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

### 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='mm')

    # Date range
    draw.text((W//2, H*0.48), date_range, font=font_md, fill=(255,215,0), anchor='mm')

    # Hook text
    draw.text((W//2, H*0.62), hook_text, font=font_md, fill='white', anchor='mm')

    # Brand
    draw.text((W//2, H*0.78), "WEEKLY TAROT", font=font_sm, fill=(200,200,200), anchor='mm')

    img.save(output_path, quality=95)

# Color schemes per sign
SIGN_COLORS = {
    'aries':       [(220,50,30),  (120,20,60)],
    'taurus':      [(30,120,50),  (15,60,30)],
    'gemini':      [(230,200,40), (180,120,20)],
    'cancer':      [(150,180,220),(60,80,140)],
    'leo':         [(240,170,30), (200,100,10)],
    'virgo':       [(80,140,80),  (40,80,50)],
    'libra':       [(200,160,200),(120,80,150)],
    'scorpio':     [(140,20,40),  (60,10,40)],
    'sagittarius': [(160,80,180), (100,40,120)],
    'capricorn':   [(80,60,50),   (30,25,20)],
    'aquarius':    [(40,100,220), (20,50,140)],
    'pisces':      [(160,130,200),(80,60,130)],
}

### 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)

### Weekly Cycle

DayContentPlatformMon12 sign readings (video)YouTube Shorts, TikTokWedMid-week energy checkInstagram ReelFriWeekend tarot pullTikTok, 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alexyuui
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T18:39:13.217Z
- Expires at: 2026-05-07T18:39:13.217Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/tarot-content)
- [Send to Agent page](https://openagent3.xyz/skills/tarot-content/agent)
- [JSON manifest](https://openagent3.xyz/skills/tarot-content/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/tarot-content/agent.md)
- [Download page](https://openagent3.xyz/downloads/tarot-content)