This project provides an AI-powered skill for generating astrological charts and analyses using the Bazi (Four Pillars of Destiny) and Ziwei Doushu (Purple Star Astrology) systems. It targets users of AI agents like Claude, Codex, and Cursor, offering precise, algorithmically generated charts and integrated analysis, presented in both detailed Markdown and visually appealing HTML formats, thereby enhancing the accuracy and depth of AI-driven fortune-telling.

How It Works

The core innovation lies in separating chart generation from analysis. Instead of relying on Large Language Models (LLMs) to guess astrological configurations, this skill employs a deterministic algorithm library (derived from Yiqi, MIT licensed) for precise Bazi and Ziwei charting. An additional algorithmic layer enriches these charts with details like "patterns," "strength," "seasonal adjustments," and "inter-element conflicts." The system then performs a "comprehensive verification" by cross-referencing conclusions from both Bazi and Ziwei systems, ensuring consistency. Finally, the LLM is tasked solely with interpreting these accurate, enriched, and cross-verified data points, rather than performing the foundational charting itself.

Quick Start & Requirements

1. Clone Repository: git clone https://github.com/dzcmemory-web/bazi-ziwei-skill.git
2. Install Calculator Dependencies: Navigate to bazi-ziwei-skill/calculator and run npm install.
3. Prerequisites: Node.js version 18 or higher is required for the calculator layer.
4. Agent Integration: Place the bazi-ziwei-skill/ directory into your AI agent's designated skills folder (e.g., ~/.claude/skills/bazi-ziwei/).
5. Usage: Interact with your agent by providing a birth date and time. The agent will prompt for the desired analysis mode (Bazi, Ziwei, or Integrated) and output format (Markdown or HTML poster).
6. Documentation: Detailed usage and testing guides are available in SKILL.md and TEST-GUIDE.md.

Highlighted Details

• Algorithmic Precision: Charting core is based on the Yiqi system (MIT), verified for accuracy.
• Integrated Analysis: Supports three modes: Bazi independent, Ziwei independent, and a combined Bazi + Ziwei verification.
• Dual Output Formats: Generates both detailed Markdown reports and a single-file, ink-wash style HTML poster.
• Cross-Agent Compatibility: Designed to work with various AI agents supporting the SKILL.md standard.
• Privacy-Focused: All chart calculations are performed locally.

Maintenance & Community

The project is maintained by dzcmemory-web. For questions or collaboration, contact dzcmemory@gmail.com. No specific community channels (like Discord or Slack) or details on major contributors/sponsorships are provided in the README.

Licensing & Compatibility

The project is released under the MIT License. This permissive license allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The project includes a disclaimer stating it is for cultural research and entertainment only and should not be used for making critical life decisions (medical, financial, legal, etc.). While charting is algorithmically precise, the final analysis relies on the capabilities of the integrated LLM. The setup requires familiarity with Node.js and npm for the charting backend.