Numerologist Skills
Three Chinese divination skills: a script computes the Qimen Dunjia and Ziwei Doushu charts, then the agent interprets. Bazi is included
- 1,617 ★ on the repository
- Last commit
Extended access
Why this level
- Python scripts run on your machine and dependencies install from `requirements.txt`
- A chart needs birth date, time and place, which is personal data you pass to the agent
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/numerologist-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Python scripts run on your machine and dependencies install from `requirements.txt`
- A chart needs birth date, time and place, which is personal data you pass to the agent
This is third-party code. Review the repository files before installing.
What it does
The repository breaks three Chinese divination systems into auditable modules: Qimen Dunjia (`qimen-dunjia/`), Ziwei Doushu (`ziwei-doushu/`) and Bazi (`bazi/`). The goal is for the model to invent less in chart calculation, school conventions, step order and reasoning. Each skill follows one order. The agent first asks questions and collects missing parameters instead of drawing a chart blindly. Then all rigid calculations, such as calendar conversions and star placement, are done by a script and not by the model. Before the output, the agent states which school and day-change rule it works under. Each skill consists of a `SKILL.md` with triggers and output limits and a `references/` folder with rules, glossary and examples. Qimen Dunjia and Ziwei Doushu have command-line scripts, `qimen_cli.py` and `ziwei_cli.py`, which read a JSON with the question and time and write a JSON with the result. Bazi works from rules and references with no script. The author asks that health, legal and financial decisions are not made from such output.
Who it is for. For people interested in traditional Chinese divination who want an agent to compute a chart with a script by reproducible rules.
Good fit when
- You want a Qimen Dunjia reading of a question: the chart for a moment, directions and timing
- You need the structure of a Ziwei Doushu natal chart: palaces, major periods and years
- You want a Bazi analysis of day master strength, structure and the ten gods
- You are studying divination and want to see which school and rules a calculation follows
- You need a reproducible chart: the same script input gives the same result
Not a fit when
- You need a health, legal or financial decision: the author states the output does not replace professional advice
- You need other systems, such as Western astrology or tarot: the set has three Chinese ones
- You need a license-clean library for a product: the repository has no license file
Example request
Read the question "should I sign the contract on Thursday morning" with Qimen Dunjia, ask clarifying questions first and name the schoolLimitations
- `qimen-dunjia` needs Python 3.11 or newer, `lunar_python` and `tzdata`, installed with `pip install -r qimen-dunjia/scripts/requirements.txt`. `ziwei-doushu` has its own `requirements.txt`.
- Bazi has no script: the calculation follows rules and references, so calendar conversions depend on the model's accuracy.
- All documentation and triggers are written in Chinese. A Russian-speaking user must ask for questions and output in Russian explicitly.
- The repository has no license, so terms of use and redistribution are undefined.
- The author calls the project an experiment in an engineering approach to divination and makes no claim that predictions can be verified.
How to disable. Delete the `qimen-dunjia`, `ziwei-doushu` and `bazi` folders from the agent's skills directory (`~/.claude/skills/` or `~/.codex/skills/`). Remove the dependencies with `pip uninstall lunar_python` and by uninstalling the other packages from `requirements.txt`.
FAQ
How do I install the divination skills in Claude Code?
Copy the folders you need (`qimen-dunjia`, `ziwei-doushu`, `bazi`) whole into `~/.claude/skills/`. For calculation run `pip install -r qimen-dunjia/scripts/requirements.txt`, or the same for `ziwei-doushu`. The README has no dedicated install command.
Why a script when there is a model?
Calendar conversions and star placement need precision, and models make mistakes there. The `qimen_cli.py` or `ziwei_cli.py` script computes the chart from an input JSON, and the model only interprets the result.
What are a school and a day-change rule?
Different schools disagree on when a new day starts and how to treat a leap month. The skill must name the chosen variant before output. For Qimen Dunjia the default ruleset is `mainline-cn-v1`.
What data does a chart need?
For Qimen Dunjia, the question, the moment and the place; for Ziwei Doushu and Bazi, birth date, time and place. If something is missing, the agent must ask instead of guessing.
Can I rely on the output for important decisions?
No. The author writes that the repository expresses a traditional practice and an experiment in constraining AI, and does not replace a doctor, lawyer or financial adviser.
Discussion
No questions or reviews yet.
Related
SkillsA Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.
A skill for BaZi charts and related systems: true solar time, compatibility, date selection and a report citing the classics
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 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 README briefly introduces the three skills and lists their purpose, structure and principles. It gives commands for running the Qimen Dunjia and Ziwei Doushu scripts, explains why calculations are moved out, and ends with a disclaimer.
README badge
Original SKILL.md
--- name: qimen-dunjia description: > 奇门遁甲排盘、解盘、择时、方位判断与理论教学技能。用户明确提到奇门遁甲、时家奇门、 奇门排盘、奇门解盘、奇门择吉、方位选择、趋吉避凶，或要求“用奇门”分析一件具体事情时， 必须使用本技能。正式排盘前先做结构化访谈，再调用脚本完成固定计算，最后再做解读与建议。 compatibility: Requires Python 3.11+, lunar_python, and tzdata; run scripts/qimen_cli.py for all fixed calculations. --- # 奇门遁甲技能 本技能面向普通求测者，默认使用 `mainline-cn-v1` 规则集。工作方式是： 1. 先访谈，确认用户到底要看什么、看哪一刻、想判断什么。 2. 再用脚本做固定计算，不靠心算排盘。 3. 最后再用奇门规则做解读、建议和风险提醒。 不要跳过访谈，不要在信息不完整时硬算，也不要把完整内部推理链直接展示给用户。 ## 触发范围 以下场景应使用本技能： - 用户要求正式奇门排盘或解盘。 - 用户要求用奇门判断一件具体事情能不能成、何时动、往哪边走、避开什么。 - 用户要求奇门择时、方位选择、趋吉避凶建议。 - 用户要求讲解奇门理论、格局、用神、盘例。 以下场景不要直接进入正式排盘： - 用户只是在闲聊玄学，没有明确要用奇门。 - 用户信息太少，连事情类型和时间都没给。 - 用户要求其他流派，而当前规则集不支持。 ## 总原则 - 默认规则集固定为 `mainline-cn-v1`，不要在正式排盘路径里混用其他流派。 - 正式排盘前必须先访谈。 - 固定计算一律调用 `scripts/qimen_cli.py`。 - 不展示完整推理链，只展示关键依据和必要计算结果。