Divination

What This Skill Does

The Divination skill provides a true-random oracle system for AI agents, leveraging /dev/urandom to ensure cryptographically secure selection of cards, symbols, and hexagrams. Unlike standard LLM generation—which relies on logical probabilities and pattern matching—this skill separates the act of selection from the act of interpretation. By utilizing the divine.sh and intuition.sh scripts, an agent can perform traditional readings using Tarot, Elder Futhark runes, I Ching, The Forty Servants, or the Arcane Bullshit oracle. This creates an authentic oracle experience where the AI remains a vessel for interpretation rather than an architect of fate, mitigating the confirmation bias inherent in large language models.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/and0r/divination

Ensure that your environment has bash permissions enabled, as the skill relies on executing local scripts stored within the scripts/ directory. Once installed, the agent will have access to all reference data files and image assets located in the references/ and images/ folders.

Use Cases

• Spiritual Counseling: Providing structured, unpredictable insights for users seeking guidance or reflection on life crossroads.
• Creative Writing: Using the intuition.sh impulses to break through writer's block by generating non-sequitur poetic fragments.
• Decision Support: Acting as a neutral third-party mediator to weigh options when logic-based analysis results in a deadlock.
• Roleplay & Worldbuilding: Acting as a dungeon master or mystical entity that provides in-game readings for players.
• Meditation & Mindfulness: Generating daily focal points via rune or hexagram draws to ground users during their day.

Example Prompts

1. "I'm at a major career crossroads. Use the Tarot deck to perform a three-card reading and help me interpret the outcome."
2. "I feel blocked on my current project. Give me 3 random intuition impulses to help me see the problem from a new angle."
3. "Consult the I Ching hexagrams regarding the state of my current relationship and provide a reading based on the result."

Tips & Limitations

To maintain the sanctity of the divination process, never attempt to simulate or 'guess' the card selection. If the exec tool is unavailable, explicitly inform the user that you cannot perform the reading; do not improvise. Always check the references/ directory before finalizing your interpretation to ensure your analysis is grounded in the traditional meanings of the chosen symbol. Trust the randomness—even when the outcome appears counterintuitive, it is your job to bridge the gap between the chaotic selection and the user's specific context. Note that the included card images are low-resolution and should be used as supporting visual media only.