shizhilya/yuan
120 stars · Last commit 2026-04-27
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.
README preview
# Yuan 🌐 **English** · [中文](./README-CN.md) `Yuan` is a unified destiny-reading skill for Codex, Claude Code, and any Agent Skills–compatible runtime. Its purpose is not to stack multiple metaphysical systems on top of each other, but to collapse birth information into a **single input surface**, then render a **production-grade reading** out of whatever methods are actually defensible in the current environment. --- ## Positioning `Yuan` cares about three things: - **Unified input** — one set of birth data, no per-system improvisation - **Unified delivery** — final results only; no method tour, no divergence analysis, no intermediate scaffolding - **Unified boundary** — run what can be run, mark what cannot, never fabricate facts In other words, `Yuan` is not a "metaphysics router" — it is a **destiny-reading renderer**.