← Back to Skills Marketplace
273
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bazi-chart
Description
Professional BaZi (八字) chart calculator and analysis tool. Calculate Four Pillars of Destiny from birth date, time, and location. Features precise solar term...
README (SKILL.md)
八字排盘 (BaZi Chart Calculator)
Professional Four Pillars of Destiny calculator with astronomical precision.
Setup
cd \x3Cskill_dir>
python3 -m venv venv && source venv/bin/activate
pip install -r scripts/requirements.txt
Only dependency: ephem (astronomy library for solar term calculation).
Usage
# Text output (default)
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male
# JSON output
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --format json
# With coordinates instead of city
python scripts/bazi.py --date 1990-08-18 --time 06:00 --lat 31.23 --lon 121.47 --gender male
# Disable true solar time correction
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --no-solar-correction
# Include annual luck (流年) for specific year
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --year 2026
What It Calculates
| Feature | Description |
|---|---|
| Four Pillars | Year, Month, Day, Hour stems and branches |
| Solar Terms | Precise astronomical calculation for month pillar boundaries |
| True Solar Time | Longitude + equation of time correction (critical for western China) |
| Hidden Stems | 本气/中气/余气 for each branch |
| Ten Gods | All stem relationships relative to Day Master |
| Five Elements | Weighted distribution (hidden stems: 60%/30%/10%) + Day Master strength |
| Major Luck | Forward/reverse periods based on gender + year stem polarity |
| Relationships | 六合, 三合, 六冲, 三刑, 六害, 天干五合, 天干冲 |
Built-in Cities
50+ Chinese cities with latitude/longitude. Pass --city 城市名 directly.
Agent Integration
When a user provides birth info in conversation, extract date/time/city/gender and run the CLI. Format the text output as a message. For deeper analysis questions, use JSON output and interpret the data.
Module Structure
bazi/
├── scripts/bazi.py # CLI entry point
├── lib/
│ ├── pillars.py # Four pillar calculation
│ ├── solar_terms.py # Solar term astronomy (ephem)
│ ├── true_solar_time.py # True solar time correction
│ ├── hidden_stems.py # Hidden stems table
│ ├── ten_gods.py # Ten gods derivation
│ ├── five_elements.py # Five elements analysis
│ ├── major_luck.py # Major luck periods
│ ├── relationships.py # Clash/combine/harm
│ ├── cities.py # City coordinate lookup
│ └── constants.py # Stems, branches, mappings
└── data/cities.json # City database
Usage Guidance
This skill appears internally consistent and runs entirely on local data/code. Before installing, consider: (1) pip will fetch ephem from PyPI—if you have strict supply-chain policies, vet that package or install in an isolated environment; (2) the code contains several algorithmic/documentation inconsistencies and potential timezone/precision quirks (e.g., comments/choices in day pillar and solar-term functions and an odd timezone adjustment in solar_terms._find_solar_term_moment) that can affect accuracy—test outputs against known references; (3) run the CLI in a sandbox (venv or container) first and review results for your test cases. If you need higher assurance, have a trusted developer review or run the tool offline after vendoring the ephem dependency.
Capability Analysis
Type: OpenClaw Skill
Name: bazi-chart
Version: 1.0.0
The skill bundle is a legitimate and well-structured professional BaZi (Chinese astrology) calculator. It uses the 'ephem' library for precise astronomical solar term calculations and includes logic for true solar time correction, five elements analysis, and major luck periods. There is no evidence of data exfiltration, malicious execution, or prompt injection; the code is transparent, lacks obfuscation, and performs only the mathematical and logical operations required for its stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the included code and CLI. The code implements pillars, solar-term astronomy (ephem), true solar time correction, hidden stems, ten-gods, five-elements, major luck and relationship analysis. The only declared/used external dependency is ephem (also present in scripts/requirements.txt), and the bundled cities.json fits the stated built-in cities feature.
Instruction Scope
SKILL.md tells the agent to extract birth info and run the local CLI; the code only reads local files (data/cities.json) and performs local computation. There are no instructions to read unrelated system files, access environment secrets, or post data to external endpoints.
Install Mechanism
No packaged install spec in registry; SKILL.md recommends creating a venv and pip installing scripts/requirements.txt (ephem from PyPI). This is expected for a local astronomy calculation but does involve fetching a third-party package from PyPI (standard but has typical supply-chain risk).
Credentials
The skill requires no environment variables, credentials, or config paths. Runtime behavior is limited to local computation and reading the provided cities.json. Nothing requests unrelated secrets or system configuration.
Persistence & Privilege
Flags show always:false and normal agent invocation allowed. The skill does not attempt to modify other skills or system-wide settings; it is an ordinary, non-persistent tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bazi-chart - After installation, invoke the skill by name or use
/bazi-chart - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: professional BaZi calculator with astronomical solar terms, true solar time correction, ten gods, five elements, major luck, and relationship analysis
Metadata
Frequently Asked Questions
What is BaZi Chart Calculator (八字排盘)?
Professional BaZi (八字) chart calculator and analysis tool. Calculate Four Pillars of Destiny from birth date, time, and location. Features precise solar term... It is an AI Agent Skill for Claude Code / OpenClaw, with 273 downloads so far.
How do I install BaZi Chart Calculator (八字排盘)?
Run "/install bazi-chart" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is BaZi Chart Calculator (八字排盘) free?
Yes, BaZi Chart Calculator (八字排盘) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does BaZi Chart Calculator (八字排盘) support?
BaZi Chart Calculator (八字排盘) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created BaZi Chart Calculator (八字排盘)?
It is built and maintained by Reed (@reed1898); the current version is v1.0.0.
More Skills