ai-divination-skills

1# AI Divination Skills
2 
3This skill wraps `ai-divination-skills` — an MCP server + Python package providing auditable tarot, I Ching, and Xiao Liu Ren divination tools.
4 
5## When to use
6- User asks for a tarot reading (e.g. 3-card, Celtic Cross)
7- User asks for an I Ching / 易经 hexagram with moving lines
8- User asks for a 小六壬 / Xiao Liu Ren / Six Yao reading
9- User wants reproducible / auditable divination (seed-based) instead of model-imagined cards
10 
11## Install
12```bash
13pip install ai-divination-skills
14```
15 
16## Workflow
171. Run the CLI for the requested method:
18   - Tarot: `ai-divination tarot --spread three-card`
19   - I Ching: `ai-divination iching --method coin`
20   - Xiao Liu Ren: `ai-divination xiaoliuren`
212. The CLI prints structured JSON (cards/lines, positions, names, keywords)
223. Interpret the JSON in natural language. **Do not** invent additional cards, swap positions, or change the result; only interpret what the JSON contains.
23 
24## MCP alternative
25If 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`.
26 
27## Links
28- Repo: https://github.com/sapuyou45-bit/ai-divination-skills
29- PyPI: https://pypi.org/project/ai-divination-skills/