Bazi Skill Chinese Astrology
Add an interactive BaZi (Four Pillars) chart and classical-text destiny analysis flow inside Claude Code for users who ask in Chinese or English.
Overview
BaZi Skill — Chinese Astrology is an agent skill for the Build phase that runs interactive Four Pillars chart calculation and classical-text BaZi analysis from birth inputs.
Install
npx skills add https://github.com/aradotso/trending-skills --skill bazi-skill-chinese-astrologyWhat is this skill?
- Stepwise collection of name, solar/lunar birth date, 时辰 hour, gender, and birthplace
- Full 四柱 chart with 大运 major cycles and 流年 annual cycles
- Analysis of 日主强弱, 十神, 五行 balance, 格局, plus career, relationship, and health themes
- Cross-references nine classical texts including 《穷通宝典》, 《滴天髓》, 《子平真诠》
- Trigger phrases such as 算八字, 看八字, bazi chart reading, and chinese astrology analysis
- Nine classical Chinese astrology texts referenced in analysis
- Four pillars plus 大运 and 流年 cycle outputs
Adoption & trust: 663 installs on skills.sh; 31 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want BaZi charting and professional-style命盘解读 in Claude Code without rebuilding classical rules, pillars, and citation flow from scratch.
Who is it for?
Builders prototyping Chinese astrology agents, cultural apps, or learning rich interactive SKILL.md patterns with real trigger lists.
Skip if: Teams needing Western natal charts only, pure API backends with no conversational UX, or products that must avoid esoteric or regulated wellness claims without legal review.
When should I use this skill?
User says 算八字, 看八字, 批八字, 排八字, 四柱命盘分析, 帮我算命, bazi chart reading, or chinese astrology analysis.
What do I get? / Deliverables
You get a completed四柱命盘, cycle tables, and structured destiny analysis tied to named classical sources after the skill walks through birth details.
- Complete BaZi four-pillars chart and cycle tables
- Structured destiny analysis with classical text cross-references
Recommended Skills
Journey fit
Shelf is Build / agent-tooling because the artifact is a conversational agent skill pattern—structured prompts, chart logic, and reference corpora—not a growth or ship pipeline. Agent-tooling captures installable SKILL.md behavior, trigger phrases, and stepwise user elicitation typical of specialty Claude skills.
How it compares
Specialized domain agent skill with classical citations—not a generic CRM, analytics MCP, or scientific critical-thinking checklist.
Common Questions / FAQ
Who is bazi-skill-chinese-astrology for?
Developers and solo builders who want BaZi命理分析 inside Claude Code, or who study it as a template for interactive, text-heavy agent skills.
When should I use bazi-skill-chinese-astrology?
During Build agent-tooling when integrating or cloning a BaZi workflow; when users trigger 算八字, 排八字, bazi chart reading, or chinese astrology analysis in chat.
Is bazi-skill-chinese-astrology safe to install?
It is a git-cloned skill package with no special system permissions implied in the README; still review the Security Audits panel on this Prism page and vet third-party repo updates before `.claude/skills` install.
SKILL.md
READMESKILL.md - Bazi Skill Chinese Astrology
# BaZi Skill — 四柱八字命理分析 > Skill by [ara.so](https://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 ```bash # 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 (