# Yi

> Yi Jing divination skill - uses coin toss simulation to generate hexagrams, provides interpretation and AI analysis.

- Skill: `spencerkit/yi` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add spencerkit/yi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spencerkit/yi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spencerkit (https://skillmd.com/u/spencerkit)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spencerkit/yi

---


# Yi Jing Divination

## Trigger

Use when user needs divination:
- "Help me divine"
- "Cast a hexagram"
- "Do a reading"
- "Yi Jing divination"

## Divination Process

### Step 1: Get Question

Method 1: User input directly
Ask: "What would you like to ask about?"

Method 2: Provide templates
If user unsure, offer common questions:
1. Career (work, promotion, entrepreneurship)
2. Wealth (investment, finances, income)
3. Relationships (love, marriage)
4. Academics (exams, education)
5. Health
6. Travel
7. Other

### Step 2: Cast Hexagram

Call `performDivination(question)` from `src/divination.js`:
1. Toss coins 6 times (simulate 3 coins)
2. Record each result (old yang, young yang, old yin, young yin)
3. Determine moving yao (if any)
4. Calculate main hexagram and changing hexagram

### Step 3: Output Hexagram

Call `formatOutput(divinationResult)`:
- Question
- 6 toss results
- Hexagram symbols (Unicode)
- Gua ci (judgments) and yao ci (line judgments)
- Moving yao explanation (if any)

### Step 4: AI Interpretation

Call `generateAIPrompt(question, divinationResult)`, then use LLM for interpretation.

Requirements:
1. Classical Chinese style but modern understandable
2. Answer:
   - Overall meaning of hexagram
   - Fortune for user's question
   - Suggestions
   - (If changing hexagram) What it means

## Data Files

### data/8-gua.json
8 trigrams:
- 乾, 兑, 离, 震, 巽, 坎, 艮, 坤
- Symbol, nature, yin/yang, number

### data/64-gua.json
64 hexagrams:
- Name, full name, gua ci, xiang, yao ci, liu qin, shi/ying

## Core Functions

| Function | Description |
|----------|-------------|
| yaoGua() | Simulate coin toss, return old/young yin/yang |
| yaoLiuCi() | Toss 6 times for complete hexagram |
| calcGua(yaos) | Calculate trigram numbers from yao |
| getGuaName(yaos) | Get hexagram name and symbol |
| getZhuAndBianGua(yaos) | Get main and changing hexagram |
| getGuaData(guaInfo) | Get detailed hexagram data |
| performDivination(question) | Execute full divination |
| formatOutput(divinationResult) | Format output |
| generateAIPrompt(question, result) | Generate AI prompt |

## Output Example

═══════════════════════════════════════
           YI JING DIVINATION
═══════════════════════════════════════

【Question】
"My career development?"

【Tossing Process】
1st: ●●● → Yin (old yin) ✦ moving
2nd: ○○● → Yin (young yin)
3rd: ○○○ → Yang (old yang) ✦ moving
4th: ○●○ → Yang (young yang)
5th: ●○○ → Yin (young yin)
6th: ○●○ → Yang (young yang)

【Hexagram】
Main: Xun (Wind) ☴
Change: Gen (Mountain) ☶
Moving yao: First, Top (becomes Gen)

【Interpretation】
【Gua Ci】"Xiao Heng Li You Wang, Li Jian Da Ren"
【Xiang】"Following wind, jun zi yi shen ming shi shi"

═══════════════════════════════════════

## AI Interpretation Example

Based on hexagram, AI should include:

### Hexagram Overview
Xun (Wind) hexagram, above and below Xun, wind blows everywhere... Gua ci means "Gradual success, beneficial to see great person."

### Analysis
- Currently in "advance/retreat" phase - indicates hesitation in career choices
- Xun represents wind, characteristic is "enter" - need to seize timing
- Moving yao indicates transformation period

### Fortune
Overall: Good with challenges
- Initial difficulties
- Good outcome with proper approach
- Key: "Li Jian Da Ren" - seek experienced guidance

### Suggestions
1. Go with the flow - leverage external forces
2. Balance flexibility with firm resolve
3. Seize opportunities - wind goes everywhere
4. Seek mentorship

### Changed Hexagram (Gen)
Gen means mountain - stability after changes. Stop and reflect before advancing.

---
Note: Yi Jing divination is for entertainment only. Major decisions require rational analysis.

## Notes

1. Entertainment only - not sole basis for major decisions
2. Sincerity reminder - if same question asked repeatedly, note "lack of sincerity"
3. Respect - maintain humble attitude
4. Rational view - "do your best, leave rest to fate"

## Hexagram Symbols

| Name | Symbol | Represents |
|------|--------|------------|
| 乾 | ☰ | Heaven |
| 兑 | ☱ | Lake |
| 离 | ☲ | Fire |
| 震 | ☳ | Thunder |
| 巽 | ☴ | Wind |
| 坎 | ☵ | Water |
| 艮 | ☶ | Mountain |
| 坤 | ☷ | Earth |

## Yao Explanations

- Old Yang (○): Yang changes to Yin
- Young Yang (○): Yang, unchanged
- Old Yin (●): Yin changes to Yang
- Young Yin (●): Yin, unchanged

Moving yao represents direction of change - key to interpretation.