HeiGe-SuanMing skill
A Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.
- 67 ★ on the repository
- Last commit
Minimal access
Why this level
- Scripts run locally over the birth data you enter; no network access is needed.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/heige-suanmingDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Scripts run locally over the birth data you enter; no network access is needed.
This is third-party code. Review the repository files before installing.
What it does
HeiGe-SuanMing computes Four Pillars (Bazi) and Zi Wei Dou Shu charts with scripts with no model guesswork. `scripts/paipan.py`, built on `lunar_python`, sets the year pillar by the start of spring and the month pillar by solar terms. Separate engines cover Meihua, Liu Yao and Qi Men Dun Jia divination, and an independent `scripts/phone_energy.py` engine analyzes the digit structure of a phone number or other string. The agent then follows `SKILL.md`: strength of the chart, useful element, structure, periods and conclusions by life area, each with its reasoning chain. Output can be a visual HTML report. The author has stopped development and asks users to treat results as entertainment and self-observation.
Who it is for. Users studying Chinese destiny analysis who want reproducible chart calculation instead of eyeballed estimates.
Good fit when
- A Bazi chart is needed from birth date and place with script calculation.
- You want a step-by-step chart reading with the source of every conclusion.
- Zi Wei Dou Shu is needed alongside the Bazi chart.
- You are curious about the digit structure of a number or other string.
Not a fit when
- You need forecasts for health, marriage, money or legal decisions; the author advises against relying on results.
- You need a validated prediction; tests confirm only calculation reproducibility.
- You need a commercial service; the PolyForm Noncommercial license forbids commercial use.
Example request
Compute a Bazi chart from this birth data by script and walk through it following SKILL.md.Limitations
The project is no longer updated; the author stopped building more precise features. Results count as entertainment and self-observation, and tests confirm calculation reproducibility but not predictive power. The PolyForm Noncommercial license excludes commercial use. Git and Python 3 are required and dependencies go into the project virtual environment. Main documentation is in Chinese. The skill needs birth date and place in the prompt to the agent, so consider your model's personal data policy.
How to disable. Delete the cloned project folder together with the `.venv` virtual environment. Saved reports stay where you wrote them.
FAQ
How do I install HeiGe-SuanMing?
Clone the whole repository, create a virtual environment with `python3 -m venv .venv`, install `requirements.txt` and let the agent read `SKILL.md`.
Which engines are included?
Bazi and Zi Wei Dou Shu for charts, Meihua, Liu Yao and Qi Men Dun Jia for moment divination and a separate phone-number digit-structure engine.
How does calculation differ from a model answer?
Scripts built on `lunar_python` compute charts and the model only reasons over finished data with a fixed method.
Can results guide decisions?
The author advises against using results for medical, legal or investment decisions and to treat them as entertainment.
Is the full phone number stored in the report?
No, by default the report shows a masked number and keeps digit-pair breakdowns separate from interpretation.
Discussion
No questions or reviews yet.
Related
SkillsThree Chinese divination skills: a script computes the Qimen Dunjia and Ziwei Doushu charts, then the agent interprets. Bazi is included
A skill that computes Bazi and Zi Wei Dou Shu charts by algorithm, then the model reads the result and builds an HTML poster.
Skill for Zi Wei Dou Shu charts: a script computes the birth chart, rules classify the pattern and an HTML report with two themes is built
A skill for BaZi charts and related systems: true solar time, compatibility, date selection and a report citing the classics
A skill that casts a Bazi chart with a built-in engine and reads it stepwise, flagging uncertainty and asking you to test claims.
An MCP server that calculates a Bazi chart from a birth date and returns the Chinese almanac, with no guessing of characters
README in short
The repository holds a skill with the method, reference files, case studies, a sample chart and calculation scripts. Tests lock in calculation reproducibility with fixed cases.