bazi-skill

Orchestrates BaZi chart interpretation, compatibility analysis, and auspicious timing workflows from code-computed chart facts.

59|5|Updated Jun 30, 2026
One-click install
npx skills add https://github.com/xuemian168/bazi-skill --skill bazi-skill-xuemian168
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bazi-skill
Source: https://github.com/xuemian168/bazi-skill
Command: npx skills add https://github.com/xuemian168/bazi-skill --skill bazi-skill-xuemian168

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lunar-javascript, and includes scripts (resource) and references (resource) components.

What problem does it solve? It enforces a strict separation between deterministic chart calculation and AI interpretation for Chinese metaphysics projects, preventing AI models from inventing BaZi pillars, Zi Wei stars, astrology placements, or divination results while producing validated structured outputs. ## Core Features & Use Cases - Fact-gated interpretation: All chart facts (Four Pillars, Da Yun, true solar time, Zi Wei, Western astrology, Qi Men, Liu Yao) must come from deterministic code like lunar-javascript or user-confirmed charts; AI only interprets confirmed evidence. - Multi-school master orchestration: A planner dispatches school personas (子平格局, 旺衰扶抑, 调候, 盲派象法, 神煞, compatibility, day-selection) that analyze the same evidence packet, then an orchestrator synthesizes results by source hierarchy. - Validated deliverables: Generates 100-year K-line fortune JSON (AnalysisResult), compatibility reports, and auspicious date/hour rankings, all checked by deterministic validator scripts before delivery. - Use Case: A user provides birth date, time, and city; the skill computes the chart via lunar-javascript, runs a multi-school consultation, and returns a culturally framed report with validated JSON. ## Quick Start Ask the AI to analyze a BaZi chart by providing gender, birth date, birth time, and birthplace, for example requesting a full reading for someone born on 1990-05-12 at 14:30 in Shanghai.

Frequently Asked Questions about bazi-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a BaZi chart analysis with AI?

Provide gender, birth date, birth time, calendar type, and birthplace with longitude or timezone. The chart pillars, Da Yun, and true solar time are computed by deterministic code such as lunar-javascript, and the AI only interprets those confirmed facts.

How does the multi-school master consultation workflow work?

An orchestrator-planner selects relevant school personas like 子平格局, 旺衰扶抑, 调候, and 盲派象法, gives each the same evidence packet, then synthesizes their findings by a source hierarchy where code facts outrank classical citations and cross-school consensus.

Can the AI calculate BaZi pillars or Zi Wei stars directly?

No. All chart facts including pillars, Da Yun, Zi Wei palaces, Western astrology placements, Qi Men plates, and Liu Yao hexagrams must be computed by deterministic code or supplied as user-confirmed charts. AI is restricted to interpretation and wording.

Does bazi-skill support Claude Code and Codex installation?

Yes. Clone the repository into ${CODEX_HOME:-$HOME/.codex}/skills/bazi-skill for Codex, or into .claude/skills/bazi-skill in a host project for Claude Code, then invoke it with natural language requests or /bazi-skill.

What are the limitations of the K-line fortune JSON output?

The AnalysisResult JSON must contain exactly 100 timeline entries from birth year to birth year plus 99, OHLC values between 0 and 100, both rising and falling candles, and exactly one isPeak entry. PDF export is not supported; output is structured, Markdown, or HTML only.

Why does the skill ask follow-up questions before analysis?

An information-completeness gate blocks analysis when essentials like birth time, location, timezone, or event constraints are missing. The skill asks one to three concise questions rather than guessing chart facts or event parameters.