---
name: AI Divination
slug: ai-divination
category: AI Engineering
description: AI Divination uses audited local tools to draw tarot, cast I Ching hexagrams, and perform Xiao Liu Ren readings. Use it when you need reproducible divination results and want the model to interpret structured JSON instead of inventing cards or lines.
github: "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/ai-divination-skills/skills/ai-divination-skills"
language: JavaScript
stars: 922
forks: 392
install: "npx degit https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/ai-divination-skills/skills/ai-divination-skills ~/.claude/skills/ai-divination-skills"
installs_to: ~/.claude/skills/ai-divination-skills
source_path: plugins/ai-divination-skills/skills/ai-divination-skills/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/ccplugins/awesome-claude-code-plugins"
added: 2026-08-22T05:20:41.710Z
last_synced: 2026-08-22T05:20:41.710Z
canonical_url: "https://dirskills.com/skills/ai-divination"
---

# AI Divination

AI Divination uses audited local tools to draw tarot, cast I Ching hexagrams, and perform Xiao Liu Ren readings. Use it when you need reproducible divination results and want the model to interpret structured JSON instead of inventing cards or lines.

**Install:**

```bash
npx degit https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/ai-divination-skills/skills/ai-divination-skills ~/.claude/skills/ai-divination-skills
```

## README

# AI Divination Skills

This skill wraps `ai-divination-skills` — an MCP server + Python package providing auditable tarot, I Ching, and Xiao Liu Ren divination tools.

## When to use
- User asks for a tarot reading (e.g. 3-card, Celtic Cross)
- User asks for an I Ching / 易经 hexagram with moving lines
- User asks for a 小六壬 / Xiao Liu Ren / Six Yao reading
- User wants reproducible / auditable divination (seed-based) instead of model-imagined cards

## Install
```bash
pip install ai-divination-skills
```

## Workflow
1. Run the CLI for the requested method:
   - Tarot: `ai-divination tarot --spread three-card`
   - I Ching: `ai-divination iching --method coin`
   - Xiao Liu Ren: `ai-divination xiaoliuren`
2. The CLI prints structured JSON (cards/lines, positions, names, keywords)
3. Interpret the JSON in natural language. **Do not** invent additional cards, swap positions, or change the result; only interpret what the JSON contains.

## MCP alternative
If the user is in Claude Desktop, register `ai-divination-mcp` (stdio JSON-RPC 2.0) and use tools: `tarot.draw`, `iching.cast`, `xiaoliuren.cast`, `interpretation_template`.

## Links
- Repo: https://github.com/sapuyou45-bit/ai-divination-skills
- PyPI: https://pypi.org/project/ai-divination-skills/