LZRight123

LZRight123 / yuan

Public

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.

agent-skills astrology bazi claude-code codex
57
9
100% credibility
Found Apr 27, 2026 at 57 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Yuan provides a unified skill for AI agents to generate polished destiny readings from birth data across multiple traditional metaphysical systems like BaZi, numerology, and astrology.

How It Works

1
🔍 Discover Yuan

You stumble upon Yuan while searching for insightful ways to explore your destiny based on your birth details.

2
📅 Gather Your Birth Info

You collect simple details like your birth date, time, place, gender, and any focus areas like career or love.

3
🤖 Chat with Your AI Helper

You tell your AI assistant about Yuan and share your birth details, asking for a complete destiny reading.

4
✨ Yuan Works Its Magic

Your AI uses Yuan to blend ancient wisdom systems into one clear, polished reading just for you.

5
📄 Review the Results

You get a neat report confirming your info, a poetic bone-weight verse, overall verdict, plus sections on career, wealth, relationships, a five-year outlook, and helpful advice.

🌟 Gain Destiny Insights

You feel empowered with a unified, professional-grade view of your life's path and practical next steps.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 57 to 57 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is yuan?

Yuan is a Python-based skill for AI agent runtimes like Codex, Claude Code, and OpenAI agents, turning a single birth data input—datetime, place, gender—into polished destiny readings across six methods: BaZi, bone-weight, numerology, Western astrology, Vedic, and Zi Wei. It solves the mess of juggling separate tools for each system by delivering one clean output: input confirmation, bone-weight verse, verdict, career/wealth/relationships breakdowns, five-year forecast, and advice. Users get production-ready results without method breakdowns or faked data.

Why is it gaining traction?

It stands out by enforcing a strict "final results only" contract—no process leaks or cross-method chatter—making outputs feel professional for agent apps. Zero-dependency core means it runs anywhere, falling back gracefully on blocked methods like precise Vedic charts. Devs dig the unified surface for bazi agents and similar, dodging per-tool tweaks.

Who should use this?

AI agent builders embedding destiny readings in chatbots or apps, especially those handling BaZi queries in Chinese markets. Claude Code or Codex users wanting plug-and-play skills for user birth inputs. Niche toolmakers prototyping metaphysical agents without building chart engines from scratch.

Verdict

Grab it if you're wiring up bazi agents—solid user-facing structure and easy install outweigh the 57 stars and 1.0% credibility score signaling early maturity. Polish docs and add runtime params to hit escape velocity.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.