Updated 5mo ago
by shizhilya
yuan
Yuan (元) — a unified destiny-reading skill for Codex, Claude Code, and Agent Skills runtimes. One input surface, six methods (BaZi / Cheng Gu / Numerology / Western / Vedic / Zi Wei), production-grade output.
204 GitHub stars (204)
+5 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | −1 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | +2 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | +1 |
| Oct 11 | 0 |
| Oct 12 | +1 |
| Oct 13 | 0 |
| Oct 14 | +1 |
| Oct 15 | 0 |
| Oct 16 | +1 |
- 6 skills (6 skills found in its SKILL.md files)
- 31 forks (31 forks)
- 5mo ago last update (Last updated 5mo ago)
Install
Skills CLI
npx skills add shizhilya/yuan
Asks which skills and agents to install. Just one: npx skills add shizhilya/yuan --skill yuan — add -g for every project.
Claude Code
git clone https://github.com/shizhilya/yuancp -r "yuan" ~/.claude/skills/yuan
Copies the yuan skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add shizhilya/yuan
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
yuan
Use when the user asks for Yuan, 元, Great Origin, 玄学, 算命, 命理, 八字, 称骨, 紫微斗数, 数字命理, western astrology, Vedic astrology, or a combined destiny reading. First collect name/gender, birth date/time, birthplace, and calendar type; then use the runnable reference methods under references, render either a conservative synthesis or a direct reading, and support a five-year fortune window centered on the cu…
SKILL.md on GitHub (opens in a new tab) -
chenggu-analysis
Structured Chinese Chenggu (“bone weight”) fortune analysis for 称骨算命 / 袁天罡称骨 tasks. Use when the user wants a deterministic lookup + structured output pipeline from birth datetime or normalized lunar components.
references/chenggu/SKILL.md on GitHub (opens in a new tab) -
numerology-analysis
Compute symbolic numerology from a person's name and birthdate using deterministic mappings only. Use for numerology / 数字命理 / 生命路径数 / 姓名映射 requests and structured numerology JSON. Do not use for predictive fortune-telling or non-symbolic advice.
references/numerology/SKILL.md on GitHub (opens in a new tab) -
vedic-analysis
使用传统吠陀占星(Vedic astrology)流程“星盘 → Nakshatra → Vimshottari Dasha”分析出生信息,输出只含“业力”和“阶段”的结构化 JSON。Use when a user asks for Vedic astrology, Nakshatra, Janma Nakshatra, Dasha, Vimshottari, karmic themes, or life-stage interpretation from birth data. Do not use for Western astrology-only requests or for scientific proof claims.
references/vedic-astrology/SKILL.md on GitHub (opens in a new tab) -
astrology-analysis
Compute and interpret a Western tropical natal chart (birth chart / natal chart / 本命盘 / 星盘) from birth datetime and location. Use for requests about planets, signs, houses, aspects, or outputs grouped into personality, career, and relationships. Skip Vedic or sidereal unless explicitly requested, tarot, horary, Chinese astrology, daily horoscopes, or astronomy-only questions unrelated to a natal…
references/western-astrology/SKILL.md on GitHub (opens in a new tab) -
ziwei-analysis
Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning. Use when the user asks to build a Ziwei skill or engine, define palaces/stars/four-transformations/limits, interpret an existing chart JSON/table, or produce deterministic-vs-heuristic output. Do not use for birth-data-only personal readings unless verified chart facts or a d…
references/ziwei/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.