What is bazi-skill?

bazi-skill is a skill you add to Codex or Claude Code that turns the AI assistant into a helper for BaZi, a traditional Chinese method of reading someone's fate from their birth date and time, along with related systems like Zi Wei Dou Shu, Western astrology, Qi Men Dun Jia, and Liu Yao divination. It also handles matching two people's charts for compatibility and picking auspicious dates and times for events. The core idea behind the project is that the actual chart, the exact positions and combinations that make up someone's birth chart, must always be computed by deterministic code rather than guessed or calculated by the AI itself. Once a chart is calculated or confirmed by the user, every later explanation has to stick to those confirmed facts. When key details are missing, such as birth location, time zone, or the precise moment used for solar time correction, the skill is meant to ask for them rather than assume. For more involved requests, the skill runs a small panel of different traditional schools of interpretation in parallel, each reading the same confirmed chart facts through its own lens, and then a final synthesizing role combines their views into one coherent answer rather than simply averaging them. It can also produce a hundred-year fortune timeline as structured JSON data, generate compatibility readings between two people's charts, and produce full readable reports in Chinese as Markdown or HTML text. To install it, you clone the repository into Codex's local skills folder or into a project's .claude/skills folder for Claude Code, then trigger it with natural language requests or the /bazi-skill command. There is also a companion validation script to check that the structured JSON output matches the expected format before it is used. The README frames its output as cultural analysis and reflection rather than certain predictions, and does not state a software license for the project.