Entertainment
Plugin
meihua-yishu
meihua-yishu is a Claude Code plugin with 1 hand-picked skill, indexed on Flowy in the Entertainment category.
Plugin Signal49/100Fair
maintained64
capable14
documented75
adopted49
Install
$ npx -y skills add muyen/meihua-yishu --agent claude-code
What's inside
Badges
README
梅花易數 Meihua Yishu
Meihua Yishu (梅花易數 / Plum Blossom Numerology / Plum Blossom I Ching) is a traditional Chinese I Ching divination method, attributed to Shao Yong (邵雍) of the Song Dynasty. This project provides a professional Meihua divination system as an AI Skill for Claude Code.
Also known as: 梅花易数 (Simplified Chinese), Mei Hua Yi Shu, Plum Blossom Oracle, 梅花心易
Prefer a web app? Try the hosted version at iyarrow.xyz — no Claude Code setup required.
Why Meihua Yishu?
A Decision-Making Framework, Not Fortune-Telling
Unlike popular misconceptions about divination, Meihua Yishu is a structured thinking tool rooted in 3,000 years of Chinese philosophical wisdom:
| Misconception | Reality |
|---|---|
| "Predicts the future" | Analyzes present conditions and likely trajectories |
| "Superstition" | Systematic framework based on pattern recognition |
| "Magic" | Philosophical method for examining situations from multiple angles |
Why "not prediction" is backed by evidence, not modesty: this project's own prediction-validation report found that computing 吉/凶 from 五行生剋 lands at coin-flip. The hexagram is a 象 to read in context (互/變/錯/綜), not a verdict to compute — and this skill deliberately reports no scores, percentages, or hexagram "types".
Benefits
🎯 Decision Clarity — When facing complex choices, the hexagram structure forces you to consider factors you might overlook
🔄 Multiple Perspectives — The Ti-Yong (体用) framework systematically examines self vs. environment, action vs. reaction
⏱️ Timing Awareness — The 應期 (Yingqi) system encourages thinking about when to act, not just what to do
🌊 Change Philosophy — Based on the I Ching principle that everything changes; helps accept uncertainty and plan adaptively
💭 Reflection Tool — The divination process creates space for introspection and deeper thinking about your situation
Who Uses It?
- Entrepreneurs — For strategic timing and partnership decisions
- Individuals — For major life choices (career, relationships, relocation)
- Curious Minds — To explore Eastern philosophy and symbolic thinking
- Developers — To integrate traditional wisdom into AI applications
The Meihua Advantage
Compared to other I Ching methods:
- Faster — No coins or yarrow stalks needed; cast from time, numbers, or observation
- More Intuitive — Trigram-based (8 symbols) rather than full hexagram memorization (64 symbols)
- Contextual — Ti-Yong analysis relates directly to your specific situation
- Practical — Clear auspicious/inauspicious framework with actionable insights
"The Yi does not predict fate — it reveals patterns. Understanding patterns empowers better choices."
Features
Casting Methods
- Time-based Divination — Cast using current or specified time. Defaults to second-level precision (a modern extension) so repeated casts within the same 2-hour 時辰 no longer collide; traditional 時辰 precision remains available (NEW!)
- Number-based Divination — Cast hexagrams using numbers
- Sound-based Divination — Cast using the count of sounds heard
- Color-based Divination — Cast based on colors corresponding to five elements
- Measurement-based Divination — Cast using object dimensions
- Direction-based Divination — Cast based on the direction of a person or object
Interpretation Functions
- Ti-Yong Analysis — Interpret the relationship between Ti (体) and Yong (用) trigrams via two complementary lenses: five-element 生克 and Trigram-Virtue 卦德 (健/順/動/入/陷/麗/止/說). Both are framed as reference lenses, never verdicts (NEW!)
- Full Relational Field — Beyond 互卦 (nuclear) and 變卦 (changing), each cast now also shows 錯卦 (complement — the opposite face) and 綜卦 (inverse — the other party's view), so a hexagram is read as a 象 in context (NEW!)
- Tongguan Mediation — Analyze five-element bridging to mitigate克 (controlling) relationships
- 64 Hexagrams Interpretation — Detailed explanations of hexagram and line texts
- Changing Lines Derivation — Analyze the fortune of transformed hexagrams
- Seasonal Strength (卦氣) — Determine Ti trigram strength based on season
- Timing Prediction (應期) — Predict when events will manifest
- Strategy Guidance (策略建議) — Every reading must close with one concrete next step, reasoned from the line text, Ti-Yong, and the transformed hexagram
Specialized Readings
- 18 Specific Readings — Marriage, illness, wealth, travel, and more
- Ten Responses (十應) — Environmental sign analysis
- Bagua Correspondences — Modern and traditional symbolic associations
- Character Analysis (測字) — Fortune telling by analyzing Chinese characters
AI-Assisted Features
- Photo Analysis — Upload photos for AI to analyze environmental signs
- Environmental Sensing — Describe surrounding sounds, colors, people for enhanced readings
Project Structure
meihua-yishu/
├── SKILL.md # Main skill documentation
├── ETHICS.md # Ethical guidelines (English)
├── ETHICS.zh-TW.md # Ethical guidelines (繁體中文)
├── README.md # This file
├── README.zh-TW.md # Traditional Chinese README
├── LICENSE # CC BY-NC-SA 4.0 License
├── references/
│ ├── 64gua.md # 64 Hexagrams detailed guide
│ ├── yaoci.md # 384 Line texts
│ ├── zhouyi-zhuan.md # Tuan & Xiang commentaries
│ ├── bagua-wanwu.md # Bagua correspondences + verses + character analysis (測字)
│ ├── hexagram-relationships.md # Hexagram relationships + Tongguan
│ ├── ying-guides.md # Ten responses + external signs
│ ├── yingqi-calc.md # Timing calculation guide
│ ├── 18-divinations.md # 18 types of specific readings
│ └── case-studies-expanded.md # Classic divination cases (optional)
└── scripts/
└── meihua_calc.py # Python calculation tool
Usage
As a Claude Code Skill
Easy way: Paste this URL in Claude Code and say "Please install this skill":
https://github.com/muyen/meihua-yishu
Manual way:
# Personal skills (works across all projects)
git clone https://github.com/muyen/meihua-yishu.git ~/.claude/skills/meihua-yishu
# Or for a specific project
git clone https://github.com/muyen/meihua-yishu.git .claude/skills/meihua-yishu
Once installed, mention divination keywords like "占卦", "起卦", or "meihua" — the skill will activate automatically.
ChatGPT Custom GPT
- Create a new GPT at https://chatgpt.com/gpts/editor
- Copy the entire content of
SKILL.mdinto the Instructions field (must be < 8000 characters) - Upload all 10 files from
references/as Knowledge files - Set conversation starters: "幫我起卦", "占一卦", "測字"
Google Gemini Gems
- Create a new Gem at https://gemini.google.com/gems
- Copy the entire content of
SKILL.mdinto the Instructions field - Upload all 10 files from
references/as Knowledge files (Gemini limit: 10 files) - Set suggested prompts: "幫我起卦", "占一卦", "測字"
Using the Python Tool
# Cast using current time — second precision by default (NEW)
python scripts/meihua_calc.py time
# Cast using current time — traditional 時辰 (2-hour) precision
python scripts/meihua_calc.py time-shichen
# Cast hexagram using two numbers
python scripts/meihua_calc.py num 6 8
# Cast hexagram using three numbers (third is changing line)
python scripts/meihua_calc.py num 6 8 3
Example output:
==================================================
📿 Meihua Yishu Divination Result
==================================================
【1. Calculation】
Year: 10
Month: 1
Day: 17
Hour: Hai (12)
【2. Primary Hexagram】
#49: Ze Huo Ge (Revolution)
Upper: Dui ☱
Lower: Li ☲
Binary: 011101
Line 4 changing
【3. Ti-Yong Analysis】
Ti Trigram: Li (lower) - Fire · 麗 (clinging)
Yong Trigram: Dui (upper) - Metal · 說 (joyous)
Five-element (reference): Ti controls Yong (Auspicious)
Trigram-Virtue (reference, stronger): You (Ti) tend toward "clinging/showing", the situation (Yong) is "joyous/pleasing" ...
【4. Mutual Hexagram (互卦)】
Qian Wei Tian (Heaven over Heaven)
【5. Transformed Hexagram (變卦)】
#17: Ze Lei Sui (Following)
Binary: 011001
【6. Complement (錯卦) — the opposite face】
Shan Shui Meng — flip every line; shows the side you didn't see
【7. Inverse (綜卦) — the other party's view】
Shui Huo Ji Ji — turn it upside down; see it from across the table
==================================================
Core Principles
Yi = Change (易 = 變)
The fundamental principle of I Ching is change. The purpose of divination is not just to predict fortune, but to guide optimal action:
- Able to change = things flow (proactive adjustment, flow with circumstances)
- Stuck in place = trouble (missing opportunities)
Every divination must include strategy guidance — telling the querent what to do next.
Early Heaven Bagua Numbers
Meihua Yishu uses Early Heaven Bagua Numbers:
| Trigram | Number | Element | Symbol |
|---|---|---|---|
| Qian (乾) | 1 | Metal | ☰ |
| Dui (兌) | 2 | Metal | ☱ |
| Li (離) | 3 | Fire | ☲ |
| Zhen (震) | 4 | Wood | ☳ |
| Xun (巽) | 5 | Wood | ☴ |
| Kan (坎) | 6 | Water | ☵ |
| Gen (艮) | 7 | Earth | ☶ |
| Kun (坤) | 8 | Earth | ☷ |
Ti-Yong Theory
- Ti (体): The subject, self, the querent
- Yong (用): The object, matter, external environment
- Mutual Hexagram (互卦): The development process
- Transformed Hexagram (變卦): The final outcome
Fortune Determination
| Situation | Fortune | Explanation |
|---|---|---|
| Yong generates Ti | Very Auspicious | Gaining benefits, external assistance |
| Ti controls Yong | Auspicious | You control the situation, success likely |
| Ti-Yong in harmony | Auspicious | Same element, harmonious and smooth |
| Yong controls Ti | Inauspicious | Constrained by others, unfavorable |
| Ti generates Yong | Draining | Much effort, little return |
Tongguan Mediation (通關化解)
When Ti and Yong are in a controlling relationship, a "bridging" element in the Mutual or Transformed hexagram can mitigate the inauspicious outcome:
| Controlling Relationship | Bridging Element |
|---|---|
| Metal controls Wood | Water |
| Wood controls Earth | Fire |
| Earth controls Water | Metal |
| Water controls Fire | Wood |
| Fire controls Metal | Earth |
Divination Principles
- No question, no divination — Don't divine without a specific question
- No more than three times — Don't repeat divination for the same question more than three times
- No movement, no divination — Don't divine without cause
- Interpret with reason — Hexagrams must be interpreted in context
References
- Meihua Yishu (梅花易數) — Shao Yong
- Zhou Yi (I Ching / 周易)
- Introduction to I Ching Studies (易學啟蒙)
License
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
You are free to:
- Share — copy and redistribute the material
- Adapt — remix, transform, and build upon the material
Under the following terms:
- Attribution — You must give appropriate credit
- NonCommercial — You may not use the material for commercial purposes
- ShareAlike — Derivatives must be distributed under the same license
Commercial Licensing: For commercial use, please contact muyen.lee@gmail.com
See LICENSE for details.
Related Projects
File tree
FAQ
meihua-yishu is a Claude Code plugin with 1 hand-picked skill, indexed on Flowy in the Entertainment category. Install it with the command on its page. It includes meihua-yishu. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is meihua-yishu?
- Meihua Yishu (梅花易數 / Plum Blossom Numerology / Plum Blossom I Ching) is a traditional Chinese I Ching divination method, attributed to Shao Yong (邵雍) of the Song Dynasty.
- How do I install meihua-yishu?
- Run these in Claude Code: npx -y skills add muyen/meihua-yishu --agent claude-code. Then prompt normally.
- Does meihua-yishu auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is meihua-yishu free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it