Repolode
FANzR-arch

FANzR-arch/Numerologist_skills

A set of AI skills for Chinese divination systems (Qimen Dunjia, Zi Wei Dou Shu, Bazi) that pairs LLM prompts with fixed calculation scripts to reduce hallucinated charts.

Stars
1,475
Forks
239
Open issues
5
Last commit
5 days ago

What is it?

Numerologist Skills packages traditional Chinese divination practices (Qimen Dunjia, Zi Wei Dou Shu and Bazi) as modular AI skills. Each skill contains a SKILL.md with triggers, workflow and output constraints, plus references that fix terminology, school conventions and judgment order.

For the parts that require exact computation, such as calendar conversion and chart layout, the Qimen Dunjia and Zi Wei Dou Shu skills delegate work to Python CLI scripts that read a JSON input and write a JSON output. The Bazi skill relies on rules and reference materials instead.

The design asks the model to collect missing parameters before producing a chart, declare which school and day-boundary rules it follows, and keep high-risk topics such as health, law and finance to structured reference rather than advice.

Key features

  • 01Qimen Dunjia skill for single-matter judgment, timing, direction and auspicious choices.
  • 02Zi Wei Dou Shu skill for natal chart structure, palace analysis and decade and yearly cycles.
  • 03Bazi skill covering day master strength, pattern, Ten Gods and luck cycles.
  • 04Python CLI scripts that produce deterministic charts from JSON input.
  • 05Reference files that fix terminology and calculation conventions.

Use cases

  • Building an LLM assistant for Chinese astrology that needs consistent chart layouts.
  • Studying how prompt constraints and external scripts can limit model errors in a rule-based domain.
  • Generating structured Qimen Dunjia or Zi Wei Dou Shu charts as input for further analysis.

Quick start

  1. 1

    Install the Qimen Dunjia script dependencies

    pip install -r qimen-dunjia/scripts/requirements.txt
  2. 2

    Run the Qimen Dunjia calculation CLI with an input JSON file

    python qimen-dunjia/scripts/qimen_cli.py --input tmp/qimen_input.json --output tmp/qimen_output.json
  3. 3

    Install the Zi Wei Dou Shu script dependencies

    pip install -r ziwei-doushu/scripts/requirements.txt
  4. 4

    Run the Zi Wei Dou Shu chart CLI with an input JSON file

    python ziwei-doushu/scripts/ziwei_cli.py --input tmp/ziwei_input.json --output tmp/ziwei_output.json

Things to know

  • The repository has no license specified, so reuse terms are unclear.
  • The README does not document the input JSON format the CLI scripts expect.
  • Bazi has no calculation script and relies only on rules and reference files.

Topics

FAQ

What is Numerologist_skills?
A set of AI skills for Chinese divination systems (Qimen Dunjia, Zi Wei Dou Shu, Bazi) that pairs LLM prompts with fixed calculation scripts to reduce hallucinated charts. Numerologist Skills packages traditional Chinese divination practices (Qimen Dunjia, Zi Wei Dou Shu and Bazi) as modular AI skills. Each skill contains a SKILL.md with triggers, workflow and output constraints, plus references that fix terminology, school conventions and judgment order.
Is Numerologist_skills free to use? What license does it have?
Numerologist_skills has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is Numerologist_skills still maintained?
Actively maintained. The last commit to Numerologist_skills was on Oct 16, 2026.
What can I use Numerologist_skills for?
Building an LLM assistant for Chinese astrology that needs consistent chart layouts. Studying how prompt constraints and external scripts can limit model errors in a rule-based domain. Generating structured Qimen Dunjia or Zi Wei Dou Shu charts as input for further analysis.
How do I install Numerologist_skills?
Install the Qimen Dunjia script dependencies: pip install -r qimen-dunjia/scripts/requirements.txt Run the Qimen Dunjia calculation CLI with an input JSON file: python qimen-dunjia/scripts/qimen_cli.py --input tmp/qimen_input.json --output tmp/qimen_output.json Install the Zi Wei Dou Shu script dependencies: pip install -r ziwei-doushu/scripts/requirements.txt Run the Zi Wei Dou Shu chart CLI with an input JSON file: python ziwei-doushu/scripts/ziwei_cli.py --input tmp/ziwei_input.json --output tmp/ziwei_output.json
Where can I get Numerologist_skills?
The source code and installation instructions are on GitHub: https://github.com/FANzR-arch/Numerologist_skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects