Pro
Zi Wei Dou Shu Purple Star Reading
Purple Star charts computed by a tested script, read palace by palace in plain English
Zi Wei Dou Shu Purple Star Reading gives your agent a reliable way to read Purple Star Astrology charts in English.
The chart is computed, not improvised. A bundled Node.js script uses the MIT-licensed iztro library to build the 12-palace board from a Gregorian or Chinese lunar birth date, the two-hour birth period and gender, with optional true solar time and documented options for the late Rat hour and year boundary. It outputs JSON with every palace in English, Chinese and pinyin: major and minor stars with brightness, the four transformations (Hua Lu, Hua Quan, Hua Ke, Hua Ji), flying and self-transformations, triad relationships, empty-palace borrowing, decade ranges with calendar years, the Life and Body palaces and the Five Element Bureau, plus the current decade and upcoming years. If the birth hour is unknown, an all-hours mode lists the twelve candidate Life palaces so the person can narrow it down.
The agent then reads the Life palace and its triad, the Career, Wealth, Spouse and Health palaces (Health only as stress and self-care patterns), the transformations and the current decade, and writes a structured reading with a glossary, in Markdown or as a self-contained HTML chart board.
What you get: skill instructions, the chart script with a self-test, a glossary, five interpretation references written for this skill, an HTML template and a complete worked example.
Readings are reflective and non-fatalistic, for self-reflection and entertainment, with no medical, financial or legal predictions. Requires Node.js 18+ and one npm install.
Highlights
- 12-palace chart from the iztro library, never guessed by the AI
- Stars with brightness, Hua Lu/Quan/Ke/Ji, decades and current year
- English names with Chinese and pinyin, plus a full glossary
- Unknown birth hour? Compare all 12 candidate Life palaces
- Reports in Markdown or a self-contained HTML chart board
Example
Can you read my Zi Wei Dou Shu chart? Born 18 June 1993, 3:20 pm, Sydney, male. Is now a good time for a career change?
Chart at a glance: Life palace 辛酉 with 天机 Heavenly Strategist (Prosperous) and 巨门 Great Gate (Temple, Hua Quan) · Body palace in Career · Wood Bureau 3 · Current decade: Children palace, 2025–2034. Your Life palace pairs the analyst and the speaker: you think in systems and need to say what you see. The Great Gate carries your natal Hua Quan, so your authority comes from your voice... Career: the palace is empty and borrows the Sun and Moon from Spouse, with the Goat Blade at Temple brightness — a sharp, competitive edge in work where analysis meets communication... 2025–2034: the decade Hua Lu lands on the Greedy Wolf, the star carrying your natal Ji, easing friction with peers, while the decade Hua Ji sits on the Strategist in your Life palace: more plans than hours. A change can work well if it narrows your focus rather than widening it.
I only know my birth date, 7 July 1995, female. Can you still do Zi Wei Dou Shu?
Zi Wei Dou Shu turns on the birth hour — each two-hour period gives a different Life palace — so rather than guess, here are some of the candidates for 7 July 1995: - Rat hour (00:00–01:00): Life palace 癸未 with 紫微 Purple Emperor + 破军 Army Breaker — a reformer who wants to lead. - Horse hour (11:00–13:00): Life palace 己丑 with 武曲 Military Treasurer + 贪狼 Greedy Wolf — driven, practical, late-blooming. - Monkey hour (15:00–17:00): Life palace 丁亥 with 武曲 Military Treasurer + 破军 Army Breaker — bold, restless, starts things. Do any of these sound like you, or do you know roughly whether you were born at night, in the morning or in the afternoon? Once we settle on an hour I'll read the full chart and mark the hour as estimated.
What's inside
ziwei-doushu-reading/ ├── agents/ │ └── openai.yaml ├── assets/ │ └── report-template.html ├── references/ │ ├── calculation-notes.md │ ├── glossary.md │ ├── major-stars.md │ ├── output-format.md │ ├── palaces.md │ ├── timing.md │ ├── transformations-and-minor-stars.md │ └── worked-example.md ├── scripts/ │ ├── package.json │ └── ziwei_chart.mjs ├── LICENSE.txt ├── README.md └── SKILL.md
Install by unzipping into your agent's skills folder. Install guide →