A community-curated open-source library of prompts for AI chat models, with a website, CSV/Hugging Face datasets, CLI and MCP server integration.
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
Install the Qimen Dunjia script dependencies
pip install -r qimen-dunjia/scripts/requirements.txt - 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
Install the Zi Wei Dou Shu script dependencies
pip install -r ziwei-doushu/scripts/requirements.txt - 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
A locally installed, power-user front end for chatting with many LLM APIs, image generators and TTS voice models.
An open format and specification for packaging instructions, scripts and resources into SKILL.md folders that AI agents load on demand.
A curated collection of 161+ ready-to-use Claude Code subagent definitions across 10 categories for development, infrastructure, security, data and more.
A compact, human-readable encoding of JSON data designed to reduce token usage when passing structured data to LLM prompts.
Python framework for building customer-facing AI agents that follow business rules, guidelines and procedures consistently by narrowing the LLM context to what is relevant each turn.