How do I install the Bazi Calculator skill?

Run npx skillmds@latest add dvcrn/bazi-calculator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bazi Calculator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bazi Calculator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bazi Calculator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bazi Calculator?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bazi Calculator by dvcrn — Agent Skill

Name: Bazi Calculator
Rating: 4.2 (5 reviews)
Author: dvcrn

Bazi Calculator

Calculate a person’s Four Pillars (BaZi / Eight Characters) from birth date and time using sexagenary-cycle offsets from one trusted reference datetime that already has known year/month/day/hour pillars. Also calculate DaYun (10-year luck cycles) when gender is provided, and include the current LiuNian (流年) Ganzhi. Use when user asks for BaZi pillars, eight characters, stem-branch pillar calculation, DaYun, or current LiuNian.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

BaZi Calculator

Calculate Year/Month/Day/Hour pillars with a single reference point.

Quick Start

Use references/reference-verified.json (or your own verified reference JSON) with one trusted reference datetime and its four pillars.
Run:

python3 scripts/calc_bazi.py \
  --birth "1992-08-14 21:35" \
  --tz "Asia/Shanghai" \
  --reference references/reference-verified.json \
  --gender male

Return results left-to-right as:

Hour pillar
Day pillar
Month pillar
Year pillar
Eight characters (Hour Day Month Year)

Workflow

1) Validate inputs

Require birth datetime (YYYY-MM-DD HH:MM).
Require timezone (default Asia/Shanghai if omitted).
Require one reference JSON with:
- reference_datetime
- reference_pillars.year/month/day/hour

2) Compute offsets from reference

Year offset: LiChun-adjusted year difference (approximation: Feb-04 00:00 local).
Month offset: calendar month difference.
Day offset: calendar day difference.
Hour offset: 2-hour bin difference (Zi starts at 23:00).

3) Shift each base pillar in 60-cycle

target_pillar = shift(reference_pillar, offset mod 60) for year/month/day/hour separately.

4) Present output

Birth (local): 1992-08-14 21:35 (Asia/Shanghai)
Hour Pillar: 丙戌
Day Pillar: 癸亥
Month Pillar: 丙申
Year Pillar: 壬申
Eight Characters (L→R Hour/Day/Month/Year): 丙戌 癸亥 丙申 壬申

Notes

This is a deterministic reference-based method.
Accuracy depends on correctness of the chosen reference and boundary rules.
For professional-grade astrology, validate solar-term boundaries and true solar time adjustments.

---name: bazi-calculatordescription: Calculate a person’s Four Pillars (BaZi / Eight Characters) from birth date and time using sexagenary-cycle offsets from one trusted reference datetime that already has known year/month/day/hour pillars. Also calculate DaYun (10-year luck cycles) when gender is provided, and include the current LiuNian (流年) Ganzhi. Use when user asks for BaZi pillars, eight characters, stem-branch pillar calculation, DaYun, or current LiuNian.---# BaZi CalculatorCalculate Year/Month/Day/Hour pillars with a **single reference point**.## Quick Start1. Use `references/reference-verified.json` (or your own verified reference JSON) with one trusted reference datetime and its four pillars.2. Run:```bashpython3 scripts/calc_bazi.py \ --birth "1992-08-14 21:35" \ --tz "Asia/Shanghai" \ --reference references/reference-verified.json \ --gender male```3. Return results left-to-right as:- Hour pillar- Day pillar- Month pillar- Year pillar- Eight characters (Hour Day Month Year)## Workflow### 1) Validate inputs- Require birth datetime (`YYYY-MM-DD HH:MM`).- Require timezone (default `Asia/Shanghai` if omitted).- Require one reference JSON with: - `reference_datetime` - `reference_pillars.year/month/day/hour`### 2) Compute offsets from reference- Year offset: LiChun-adjusted year difference (approximation: Feb-04 00:00 local).- Month offset: calendar month difference.- Day offset: calendar day difference.- Hour offset: 2-hour bin difference (Zi starts at 23:00).### 3) Shift each base pillar in 60-cycle- `target_pillar = shift(reference_pillar, offset mod 60)` for year/month/day/hour separately.### 4) Present output```textBirth (local): 1992-08-14 21:35 (Asia/Shanghai)Hour Pillar: 丙戌Day Pillar: 癸亥Month Pillar: 丙申Year Pillar: 壬申Eight Characters (L→R Hour/Day/Month/Year): 丙戌癸亥丙申壬申```## Notes- This is a deterministic reference-based method.- Accuracy depends on correctness of the chosen reference and boundary rules.- For professional-grade astrology, validate solar-term boundaries and true solar time adjustments.

Frequently asked questions