# AI Divination Skills

Use this skill when the user asks for a tarot reading, I Ching (Yijing) hexagram cast...

- Repository: https://github.com/ccplugins/awesome-claude-code-plugins (991 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-08-12
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ccplugins/awesome-claude-code-plugins --skill ai-divination-skills -g -a claude-code -y`
Codex: `npx skills add ccplugins/awesome-claude-code-plugins --skill ai-divination-skills -g -a codex -y`
Cursor: `npx skills add ccplugins/awesome-claude-code-plugins --skill ai-divination-skills -g -a cursor -y`
Gemini CLI: `npx skills add ccplugins/awesome-claude-code-plugins --skill ai-divination-skills -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ccplugins/awesome-claude-code-plugins`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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/