A professional-grade tarot reading module that enables AI agents to conduct deep-dive spreads, provide energy guidance, and generate visual card interpretations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vincitarot
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 vincitarot 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 Tarot Skill?
The Tarot Skill is a sophisticated extension designed for Openclaw Skills that transforms a standard AI agent into a professional tarot reader. It goes beyond simple card lookups by implementing a full reading lifecycle: clarifying user intent, selecting optimal spreads, guiding energy centering, and weaving complex card meanings into a cohesive narrative. By supporting 78 cards with upright and reversed meanings across general, love, and career contexts, it provides a high-fidelity spiritual or reflective experience.
This skill is built with a focus on professional reader ethics, ensuring the AI maintains a supportive, non-dogmatic tone while encouraging user reflection. It includes built-in logic for selecting from multiple spread types, including the 10-card Celtic Cross, ensuring that every reading is tailored to the user's specific situation and question.
Tarot Skill Use Cases
- Providing daily energy checks and quick guidance through single-card draws.
- Conducting in-depth relationship analysis to explore connection dynamics and future potential.
- Offering career and financial insights for users navigating job changes or business decisions.
- Facilitating complex situational analysis using the traditional Celtic Cross spread for major life choices.
- Enabling mindfulness and self-reflection through guided energy-tuning prompts before card draws.
How Tarot Skill Works
- The AI agent first clarifies the user's question to determine the focus area and intent.
- The system selects the most appropriate spread (e.g., three-card, relationship, or career) based on the user's inquiry.
- The user is guided through a brief centering exercise to focus their energy before the virtual draw.
- The agent triggers the reading function, which simulates a shuffle and draw from a 78-card deck with specific upright/reversed probabilities.
- A Python script generates a visual image of the spread, correctly orienting cards based on their drawn state.
- The agent interprets the cards positionally, weaving a narrative that connects the card meanings to the user's specific question.
- Follow-up questions are provided to encourage the user to integrate the reading into their personal context.
Tarot Skill Setup
To install and configure the Tarot Skill within your Openclaw Skills environment, ensure you have Python 3 and the required dependencies installed.
# Install required Python dependencies
pip install Pillow
# Export the card data and images from the game source
python -m tarot_skill.scripts.export_cards_from_tarot_game
# Ensure the cards directory contains images named {id}.jpg for visual generation
The skill relies on a data/cards.json file for meanings and a spread_layouts.py module for visual positioning.
Tarot Skill Data Schema & Taxonomy
The skill utilizes a structured data format to ensure consistency across readings. The response object includes the following primary components:
| Component | Description |
|---|---|
spreadType |
The identifier for the spread used (e.g., celtic_cross, relationship) |
spread |
A list of objects containing card IDs, names, and whether they are reversed |
positionName |
The specific role of each card in the layout (e.g., 'Past', 'Obstacle') |
summary |
A generated draft of interpretations based on the focus (general/love/career) |
Tarot Skill Advanced Features
- Context-aware interpretations that adjust meanings based on general, love, or career focuses.
- Weighted random generation providing a 65% upright bias for specific 'Future' card positions.
- Dynamic image generation that creates a single PNG layout of the entire spread with rotated assets.
- Multi-turn dialogue capability allowing users to ask for deeper interpretations of specific cards in a draw.
- Fallback image generation using text-based placeholders if local card art is unavailable.
SKILL.md
Loading
Related Openclaw Skills
Agent Team Builder
An interactive framework for designing, configuring, and deploying multi-agent collaboration teams using standardized OpenClaw architecture.
Fullstack Project Creator
Automates the creation of standardized Java Spring Boot and Vue3 full-stack project structures with integrated database scripts and Docker configuration.
WeChat Article Reader (weixin-reader-oc)
A high-performance extraction tool for retrieving full text and metadata from WeChat Public Account articles without requiring a login.
Oura Ring CLI
A command-line tool for retrieving comprehensive health and biometric data from the Oura Ring API (V2).
Dida365 (TickTick) Task Manager
A comprehensive CLI-based tool for managing Dida365 tasks and projects through Openclaw Skills.
TickTick Official CLI Skill
A command-line interface for managing Dida365 projects and tasks using the official Open API and OAuth authentication.
Featured*
