Yuan

Yuan is an all-in-one destiny-reading skill by GitHub user shizhilya. It works with Codex and Claude Code, and with other Agent Skills runtimes. It covers six systems: Bazi, Zi Wei Dou Shu, Western astrology, Vedic astrology, numerology, and Chinese bone-weight reading (chenggu). Your birth time, place, calendar, gender, and the topics you care about go into one shared input first, then out to each system, and the author says this keeps the same details from being read under different conventions. The finished reading runs in a set order by default: confirmation of your details, the bone-weight verse, the conclusion, career, money, relationships, a five-year outlook, and suggestions. You can pick from three styles: restrained, blunt, or a five-year window. The author says it won't invent stars or palaces when it lacks a reliable chart, and it flags the parts it can't calculate. Six Eastern and Western systems share one input and end up in one report, which is what sets it apart from single-system skills.

Who it's for:People who want to read several Eastern and Western systems side by side. No coding needed, but you'll have to know which folder the skill goes in.

Before you start: Put the whole folder in .agents/skills/yuan/ for Codex, or .claude/skills/yuan/ for Claude Code, at either the project or user level. Basic readings need no extra installs. For precise charts you can add the scripts and dependencies in the reference folders (such as pyswisseph), which may download and compile packages. One reference guide suggests adding a few lines to AGENTS.md or CLAUDE.md in your project root so the AI can find the skill, so think it over before you edit those files. The project doesn't upload anything, but the name, birth time, and place you enter are processed by whichever AI model you use. No extra API key is needed, and model costs are yours. The repo has no license. The author says it doesn't present these practices as scientific fact. AI Inspiration World does not recommend using it for health, medical, or investment decisions.

Based on the project's public documentation. Not tested by AI Inspiration World.