An advanced AI-powered tarot consultation tool that provides full-process tarot readings, multiple system support, psychological archetypal insights, and elegant interactive HTML visualization reports.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ai-tarot-guide
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ai-tarot-guide using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AI Tarot Guide?
AI Tarot Guide is a comprehensive tarot reading, interpretation, and learning skill developed for AI coding agents. It covers the full details of all 78 tarot cards (22 Major Arcana and 56 Minor Arcana including Court Cards) across three major tarot systems: Rider-Waite-Smith (RWS), Crowley Thoth, and Tarot of Marseilles. Deeply grounded in Jungian psychology, projection theory, and synchronicity, the skill transforms traditional fortune-telling into a profound tool for self-exploration and spiritual growth.
By leveraging advanced markdown references and custom analytical methodologies, it delivers objective, empathetic, and multi-dimensional readouts. To enhance user experience, the skill goes beyond plain text by automatically rendering a beautifully stylized, self-contained interactive HTML visualization report complete with element distribution charts and responsive card layouts.
AI Tarot Guide Use Cases
- Personal Growth & Exploration: Users seeking deep self-reflection, understanding of their internal states, or psychological archetypal insights.
- Tarot Consultations: Generating comprehensive professional-grade readings using classic spreads like the Three-Card spread, Celtic Cross, Relationship Spread, or Zodiac 12 Houses.
- Tarot Learning & Reference: Aspiring tarot readers and enthusiasts looking to query the precise meanings, symbolic elements, and comparative analysis of specific cards and systems.
- Interactive Report Generation: Creating downloadable, responsive visual summaries of tarot sessions for preservation or sharing.
How AI Tarot Guide Works
- Information Gathering: The agent collects the user's core inquiry, preferred card spread, and determines whether the user provides their own drawn cards or requires automated random card pulling.
- Spread Setup & Selection: The skill matches the query to the best suited spread (defaulting to the Mind-Body-Spirit Three-Card model if none is specified) and establishes card orientation (upright or reversed).
- Dynamic Reference Loading: The system pulls from localized markdown references according to the drawn suits (e.g., Major Arcana, Wands, Cups, Swords, Pentacles) alongside history, spreads, reading methods, psychology, and ethics datasets.
- In-depth Interpretation: Every card undergoes a five-dimensional analysis covering naming, visual elements, specific placement context, and Jungian psychological insights.
- Synthesized Analysis: The system computes overall elemental distribution ratios (Fire, Water, Air, Earth) and Major vs. Minor Arcana proportions to present a cohesive narrative arc.
- HTML Report Generation: A standalone, zero-dependency HTML dashboard is constructed featuring Chart.js integration, responsive cards, and an empathetic call-to-action wrapper.
AI Tarot Guide Setup
To integrate this skill into your environment, ensure you place the SKILL.md along with the corresponding reference assets inside your skill directory structure.
# Create the required folder hierarchy
mkdir -p skills/ai-tarot-guide/references
# Clone or move the reference markdown files into place
# Ensure major-arcana.md, minor-arcana-wands.md, spreads.md, ethics.md, etc. reside in the references folder.
Configure your system prompts or agent profile to trigger whenever keywords such as "tarot", "占卜", "抽牌", "韦特塔罗", or "凯尔特十字" are detected.
AI Tarot Guide Data Schema & Taxonomy
The skill manages its underlying knowledge graph and behavioral limits via a modular directory schema structured as follows:
| File path | Purpose |
|---|---|
references/major-arcana.md |
Contains meticulous symbolic and positional meanings for all 22 Major Arcana cards. |
references/minor-arcana-[wands/cups/swords/pentacles].md |
Stores keywords, visual cues, and upright/reversed definitions for the 56 Minor Arcana cards. |
references/spreads.md |
Defines geometrical positions and contextual inquiries for Celtic Cross, Relationship, and Zodiac arrays. |
references/tarot-psychology.md |
Provides the conceptual framework for Jungian archetypes, projection, and synchronicity analysis. |
references/ethics.md |
Imposes strict operational guardrails such as a 3-month reading limit, non-medical clauses, and positive framing. |
AI Tarot Guide Advanced Features
- Multi-System Fluidity: Automatically switches perspective and symbolism when the user mentions "Thoth" (Crowley) or "Marseilles" systems instead of the default Rider-Waite-Smith.
- Strict Ethical Boundaries: Built-in algorithmic constraints enforce a non-fear-mongering approach for historically ominous cards (e.g., Death, The Tower, Ten of Swords) by focusing on renewal and positive pivots.
- Interactive Data Visualization: Dynamically injects an external Chart.js dependency inside the output HTML file to render a pie chart representing the elemental composition (Fire/Water/Air/Earth) of the session.
- Responsive UI Card Stacking: Employs an RWS-themed design language with deep purple and gold accentuation configured to elegantly stack into a mobile-friendly column on viewports smaller than 768px.
SKILL.md
Loading
Related Openclaw Skills
Bank Health & FDIC Data
An AI-native financial risk assessment tool that checks US bank health, active FDIC status, assets, and deposits with zero-signup, pay-per-call pricing.
AI Jewelry Appraiser
An expert AI appraisal assistant that uses domain knowledge and real-time market data to grade diamonds, analyze gemstones, decode certificates, and generate interactive HTML reports.
GitHub & Developer Data Tools
A developer data utility that provides live GitHub metadata, risk scoring audits, user profiles, and gist details directly to AI agents via a streamlined pay-per-call (x402) model.
Economic Data — FRED, World Bank & Market Stats
A real-time economic data integration giving AI agents instant access to FRED, World Bank indicators, and US market analytics via pay-per-call USDC.
Chinese Argumentative Essay & Op-Ed Writer
An advanced AI-powered Chinese essay and op-ed writing skill designed to produce highly personalized, non-generic, and deeply insightful argumentative content.
StockEarningCN Assistant (secn)
An AI-powered A-share investment and portfolio tracker designed to query stock prices, log transactions, and calculate real-time gains directly from your workspace.
Featured*
