# bazi-skill-chinese-astrology

bazi-skill-chinese-astrology calculates Four Pillars of Destiny astrology charts from birth details. It maps elemental balance and life cycles using rules from classical Chinese treatises.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 953 installs · ★ 98 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/bazi-skill-chinese-astrology/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bazi-skill-chinese-astrology

## What it does

This skill guides the assistant through calculating a Four Pillars chart. The prompt collects information sequentially rather than in one dump. It asks for the person's birth date, birth hour, birthplace, and gender. Birthplace serves to correct time offsets.

Internal reference tables handle the conversions. Markdown files in `references/` supply rules for heavenly stems, earthly branches, and ten-year cycles. Gender determines whether cycles advance forward or in reverse. Missing gender data breaks the cycle calculation order. The skill then counts five-element distribution across all pillars and assesses chart patterns against classical Chinese treatises.

The assistant finishes with a Markdown summary. This output details the dominant day stem, element deficiencies, and notes on work and personal timing.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bazi-skill-chinese-astrology -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bazi-skill-chinese-astrology/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bazi-skill-chinese-astrology/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bazi-skill-chinese-astrology -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bazi-skill-chinese-astrology/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bazi-skill-chinese-astrology -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bazi-skill-chinese-astrology/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills skills/bazi-skill-chinese-astrology
```

2. **Manually: put the files in place**
- File: `.github/skills/bazi-skill-chinese-astrology/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bazi-skill-chinese-astrology -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/bazi-skill-chinese-astrology
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bazi-skill-chinese-astrology/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bazi-skill-chinese-astrology -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/bazi-skill-chinese-astrology/SKILL.md

## When to use it
- build a Four Pillars chart from calendar and clock time
- calculate ten-year life cycle directions based on gender and stem polarity
- evaluate elemental balances including hidden branch stems
- generate destiny reports grounded in classical Chinese astrology texts

## Example prompts
- Calculate my BaZi chart from my birth details
- Set up the four pillars of destiny and check my elemental balance
- Run a Chinese astrology analysis for my birth date and hour

## Similar
- [Ziwei & Bazi Astrology](https://affpapa.org/en/nevibecode/mcp/ziwei-bazi-astrology.md) — MCP server · 976 installs
- [bazi-reader-mcp](https://affpapa.org/en/nevibecode/mcp/bazi-reader-mcp.md) — MCP server · 587 installs
- [OpenFate Bazi MCP](https://affpapa.org/en/nevibecode/mcp/openfate-bazi-mcp.md) — MCP server · ★ 162 repo stars
- [PanchangaAPI — Vedic Astrology](https://affpapa.org/en/nevibecode/mcp/panchangaapi-vedic-astrology.md) — MCP server · 310 installs
- [mythsensus](https://affpapa.org/en/nevibecode/mcp/mythsensus.md) — MCP server · 385 installs
- [personal-chinese-writing-style](https://affpapa.org/en/nevibecode/skills/personal-chinese-writing-style.md) — skill · 408 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 211 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
