Tarot Reading Research Skill

Standalone Agent Skill for studying Tarot decks, card iconography, historical lineages, spread logic, reversals, and reflective readings.

It teaches an AI to keep the deck edition, draw procedure, card observation, historical tradition, interpretive school, and reflective question separate. The bundled 78-card catalogue keeps identifiers and study prompts separate from images and meanings; the tool makes seed, algorithm, deck digest, positions, source IDs, and reversals inspectable. It never presents a draw as a forecast.

Install with gh skill install ProfesseurHaipeng/tarot-reading-research-skill --skill tarot-reading-research --pin v0.2.0.

python3 skills/tarot-reading-research/scripts/transparent_spread.py \
  --seed demo-2026 \
  --spread three-card-reflection

# Record a card draw the user already performed; | is the separator.
python3 skills/tarot-reading-research/scripts/transparent_spread.py \
  --mode physical \
  --spread three-card-reflection \
  --cards 'The Fool|Ace of Cups|Justice'

The repository includes:

• a full 78-card textual RWS-lineage identifier catalogue, with individual visual-study prompts but no bundled artwork;
• historic and modern interpretive lenses that never pretend to be one universal Tarot system;
• reproducible demo / replay, non-replayable OS-random, and user-supplied physical draw modes;
• source/citation rules, a structured Tarot research-record schema, and standard-library tests.

This is cultural research and self-reflection, not medical, financial, legal, or deterministic life advice.