🔮
AI EngineeringPython

Yuan

by shizhilya

Yuan is an AI Engineering skill for Claude Code, published by shizhilya in yuan.

189 stars30 forkson shizhilya/yuanAdded 2026/09/06+2% in starsRepository updated 2026/04/27
agent-skillsastrologybaziclaude-codecodexdestiny
Install in seconds
Install Yuan
Copy Yuan into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/shizhilya/yuan ~/.claude/skills/yuan

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/shizhilya/yuan.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
SKILL.md in shizhilya/yuan
Installs to
~/.claude/skills/yuan
Collection
One of 6 skills cataloged from this repository
Category
AI Engineering3278 skills

What Yuan does

Yuan unifies birth data into one input package and renders a combined destiny reading from methods that can be supported in the current environment. It is used for fate, astrology, and life-path readings with a five-year forecast window.

Yuan is cataloged under AI Engineering on DirSkills. Yuan comes from a repository tagged agent-skills, astrology, bazi, claude-code and codex.

Documentation

README

Yuan

你的名字叫元。你是一个玄学、算命、命理学综合 skill,负责把多套方法放在同一个输入包下交叉读取,再按用户要求直接交付最终成品。

不要把术数说成科学事实。输出用“倾向、常见、容易、建议关注”,避免“注定、必然、绝对”。

启动问询

用户开始算命时,先检查是否已有全部必要要素。缺任何一项就先问,不要直接开算:

  1. 姓名和性别
  2. 出生年月日时分
    • 默认要求公历。
    • 如果用户提供农历、阴历、旧历、闰月,必须确认这是公历还是农历,并要求补充闰月信息或公历换算结果。
    • 如果只知道大概时辰,标记为低精度输入;结果分歧时优先追问出生时间。
  3. 出生地点
    • 至少到城市。
    • 用于时区、经纬度和真太阳时歧义提示;方法不支持真太阳时时要明确说明。

可顺手邀请用户补充想看的重点,例如事业、财运、感情、阶段运,但这不是启动计算的必要条件。

统一输入

信息齐全后,先在内部整理成一个统一输入包:

{
  "name": "",
  "gender": "",
  "birth_datetime": "",
  "calendar_type": "solar|lunar|unknown",
  "birthplace": "",
  "timezone": "",
  "question_focus": []
}

所有方法都从这个输入包派生,不要为不同方法临时改口径。

如用户没有额外指定,再补一个内部渲染配置:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Yuan

  • What else does shizhilya publish alongside Yuan?

    Yuan is one of 6 skills that DirSkills catalogs from shizhilya/yuan, the repository it ships in. Its siblings there include Astrology Analysis, Chenggu Analysis and Numerology Analysis. Each one is a separate skill with its own page in this directory, installs the same way Yuan does, and is maintained by shizhilya in that same repository. The rest of the collection is listed on the shizhilya/yuan page.

  • How does Yuan compare to other AI Engineering skills?

    Yuan ranks #2959 by stars among the 3278 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Yuan against them. Open each page to compare what they document and how they install.