bazi-skill-chinese-astrology

BaZi Skill — 四柱八字命理分析

Skill by ara.so — Daily 2026 Skills collection.

A Claude Code skill for interactive BaZi (Four Pillars of Destiny) chart calculation and analysis, referencing nine classical Chinese astrology texts. Guides users through birth information collection, produces a complete 四柱 chart, and delivers professional destiny analysis.

What This Skill Does

• Interactive information collection — step-by-step prompts for name, birth date (solar/lunar), birth hour (时辰), gender, and birthplace
• Chart calculation — derives Year/Month/Day/Hour pillars (年柱/月柱/日柱/时柱), calculates 大运 (major cycles) and 流年 (annual cycles)
• Comprehensive analysis — day master strength (日主强弱), ten gods (十神), five elements balance (五行), pattern determination (格局), career, relationships, health guidance
• Classical text references — cross-references nine canonical texts including 《穷通宝典》, 《滴天髓》, 《子平真诠》, and more

Installation

# Install to current git project (run from repo root)
mkdir -p .claude/skills
git clone https://github.com/jinchenma94/bazi-skill .claude/skills/bazi

# Install globally (available in all projects)
git clone https://github.com/jinchenma94/bazi-skill ~/.claude/skills/bazi

After installation, Claude Code automatically discovers the skill from .claude/skills/bazi/SKILL.md or ~/.claude/skills/bazi/SKILL.md.

Project Structure

bazi-skill/
├── SKILL.md                  # Skill entry point (this file)
├── references/
│   ├── wuxing-tables.md      # Five elements, heavenly stems, earthly branches, ten gods
│   ├── shichen-table.md      # Time period conversion table, daily time calculation
│   ├── dayun-rules.md        # Major cycle forward/reverse rules, starting age calculation
│   └── classical-texts.md    # Core rules from nine classical texts
├── LICENSE
└── README.md

Triggering the Skill

Type any of these in Claude Code to activate:

算八字    看八字    批八字    排八字
四柱      命盘      算命      排盘      bazi

Step-by-Step Workflow

When triggered, follow this exact sequence:

Step 1: Collect Birth Information

Ask the user for these fields one at a time (do not ask all at once):

1. 姓名 (Name) — optional, for personalization
2. 性别 (Gender) — 男/女, affects 大运 direction
3. 出生日期 (Birth date) — ask whether 阳历 (solar) or 农历 (lunar)
4. 出生时辰 (Birth hour) — see shichen-table.md for conversion
5. 出生地点 (Birthplace) — province/city for timezone adjustment

Step 2: Convert to Four Pillars

Reference references/wuxing-tables.md for all lookup tables.

Year Pillar (年柱):

Year stem index  = (year - 4) mod 10  → maps to 天干
Year branch index = (year - 4) mod 12  → maps to 地支

Month Pillar (月柱):

Month branch is fixed by solar term (节气), not calendar month.
Month stem is derived from year stem using the 五虎遁年起月法 table.

Day Pillar (日柱):

Use pre-calculated 万年历 (perpetual calendar) lookup.
Day stem/branch cycle repeats every 60 days (六十甲子).

Hour Pillar (时柱):

Convert clock time → 时辰 (see shichen-table.md)
Hour stem derived from day stem using 五鼠遁日起时法 table.

Step 3: Identify Day Master (日主)

The Day Pillar's Heavenly Stem is the Day Master — the central reference point for all analysis.

Example: 日柱 = 甲子
Day Master = 甲 (Wood, Yang)

Step 4: Calculate 大运 (Major Cycles)

Reference references/dayun-rules.md:

Male + Yang year stem  → Forward (顺排)
Male + Yin year stem   → Reverse (逆排)
Female + Yang year stem → Reverse (逆排)
Female + Yin year stem  → Forward (顺排)

Starting age = days to next/previous 节气 ÷ 3 (round to nearest integer)
Each 大运 lasts 10 years.

Step 5: Determine Ten Gods (十神)

Cross-reference Day Master against each pillar stem using the 十神 table in references/wuxing-tables.md:

Step 6: Assess Five Elements Balance (五行平衡)

Count Wood/Fire/Earth/Metal/Water across all 8 characters (stems + branches).
Note hidden stems (藏干) in branches — include these in element count.
Identify excess and deficiency.

Step 7: Determine Pattern (格局)

Reference references/classical-texts.md — 《子平真诠》 and 《三命通会》 sections:

普通格局 (Common patterns): 正官格, 七杀格, 正印格, 偏印格,
                            食神格, 伤官格, 正财格, 偏财格
特殊格局 (Special patterns): 从格, 化格, 专旺格, etc.

Month branch hidden stem often determines the primary pattern.

Step 8: Full Analysis Output

Structure your analysis report as follows:

## 八字命盘 | BaZi Chart

**姓名**: [Name]  **性别**: [Gender]  **出生**: [Date Time]

| 柱  | 天干 | 地支 |
|-----|------|------|
| 年柱 | X   | X   |
| 月柱 | X   | X   |
| 日柱 | X   | X   |
| 时柱 | X   | X   |

**日主**: X（X行，X）

---

## 大运排列

起运年龄: X岁（约 XXXX 年起）

| 序 | 大运 | 年份 | 十神 |
|----|------|------|------|
| 1  | XX  | XXXX–XXXX | XX |
...

---

## 命理分析

### 日主强弱
[Assessment of day master strength based on seasonal support, roots, and helpers]

### 五行分析
[Element count and balance assessment]

### 格局判定
[Pattern name and explanation, citing classical text]

### 十神解读
[Key ten god relationships and their implications]

### 大运流年
[Current and upcoming major/annual cycle analysis]

### 综合建议
**事业**: [Career guidance]
**感情**: [Relationship guidance]  
**健康**: [Health guidance]
**择吉**: [Auspicious timing suggestions]

---
*参考典籍: 《穷通宝典》《三命通会》《滴天髓》《渊海子平》《千里命稿》*
*免责声明: 仅供传统文化学习与娱乐参考，不构成任何决策依据。*

Key Reference Tables

天干 Heavenly Stems

甲(Wood+) 乙(Wood-) 丙(Fire+) 丁(Fire-) 戊(Earth+)
己(Earth-) 庚(Metal+) 辛(Metal-) 壬(Water+) 癸(Water-)

地支 Earthly Branches

子(Water+/Rat)  丑(Earth-/Ox)   寅(Wood+/Tiger) 卯(Wood-/Rabbit)
辰(Earth+/Dragon) 巳(Fire-/Snake) 午(Fire+/Horse) 未(Earth-/Goat)
申(Metal+/Monkey) 酉(Metal-/Rooster) 戌(Earth+/Dog) 亥(Water-/Pig)

五虎遁年起月法 (Month Stem from Year Stem)

Year stem 甲/己 → January stem starts at 丙
Year stem 乙/庚 → January stem starts at 戊
Year stem 丙/辛 → January stem starts at 庚
Year stem 丁/壬 → January stem starts at 壬
Year stem 戊/癸 → January stem starts at 甲

五鼠遁日起时法 (Hour Stem from Day Stem)

Day stem 甲/己 → 子时 stem = 甲
Day stem 乙/庚 → 子时 stem = 丙
Day stem 丙/辛 → 子时 stem = 戊
Day stem 丁/壬 → 子时 stem = 庚
Day stem 戊/癸 → 子时 stem = 壬

Classical Texts Quick Reference

Full excerpts and rules are in references/classical-texts.md.

Common Patterns & Troubleshooting

Lunar to Solar Date Conversion

• Always confirm whether user provides 阳历 (Gregorian) or 农历 (lunar)
• Use 万年历 lookup for lunar→solar conversion before calculating pillars
• Intercalary months (闰月) require special handling

Solar Term (节气) Boundaries

• Month pillar changes at 节 (first solar term of month), NOT at month start
• Critical for people born near the 1st–8th of a month
• When uncertain, inform user their month pillar may differ by one month

Timezone Adjustment

• Standard Chinese charts use Beijing time (UTC+8)
• Users born outside China: convert local birth time to Beijing time
• Some practitioners use true solar time (真太阳时) — note if applying this

Day Master Strength Assessment Checklist

✓ Is the birth season supportive? (得令)
✓ Does the day branch support the day master? (得地)  
✓ Do other stems help the day master? (得助)
Strong (身强) if 2+ conditions met; Weak (身弱) if 0–1 conditions met.

Missing Information Handling

• If user cannot provide exact birth time: analyze without hour pillar, note limitation
• If only year/month known: provide partial analysis with appropriate caveats
• Never fabricate birth data — always ask for clarification

Example Interaction

User: 帮我算八字

Claude: 好的，我来为您排八字！请问您的性别是？

User: 女

Claude: 好的。请问您的出生日期是阳历还是农历？

User: 阳历，1990年3月15日

Claude: 明白了。请问您出生的时辰或具体时间？

User: 早上8点半

Claude: 早上8点半是辰时（07:00–09:00）。请问出生地点？

User: 上海

Claude: [Proceeds to calculate pillars, 大运, and full analysis]

Disclaimer

本 Skill 仅供传统文化学习与娱乐参考，分析结果不构成任何医疗、法律、财务或人生重大决策依据。命理学属于传统文化范畴，请理性看待。