---
name: ccplugins-ai-divination-skills
description: "Use this skill when the user asks for a tarot reading, I Ching (Yijing) hexagram cast, or Chinese Xiao Liu Ren (小六壬) divination. Calls audited local Python tools that produce deterministic JSON output; the model never invents the result, it only interprets the JSON."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "5a717422-5028-492e-907e-fc765d57f0ca"
  decimalai-version-id: "8e7fb8dd-82f7-4092-99b2-78882cde124f"
  decimalai-version: "1"
  decimalai-body-sha256: "dd90551c07da9a109803879780550188b2c07eaac845abededa9a61c46a6211c"
  decimalai-name: "ccplugins/ai-divination-skills"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-source: "https://app.decimal.ai/s/ccplugins-ai-divination-skills@1/SKILL.md"
---
# 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/