# FANzR-arch/Numerologist_skills

🔮 An engineering framework to stop LLM hallucinations in Chinese astrology. / 给“赛博半仙”戴上紧箍咒：减少幻觉、固定排盘步骤的奇门遁甲与紫微斗数 AI skills。

Repository: https://github.com/FANzR-arch/Numerologist_skills
Canonical: https://ross.abutalabs.com/products/numerologist_skills
Homepage: https://numerologist-skills.vercel.app
Language: Python
License Family: other
Last push: 2026-08-03T05:05:19+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 35, longevity 11
- inputs: {"age_days": 161, "days_push": 30, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1092, forks 181 (observed 2026-08-28T04:03:32.912196+00:00)

## What it is
An engineering framework of AI skills for Chinese metaphysics (Qimen Dunjia, Ziwei Doushu, BaZi) that reduces LLM hallucinations by enforcing structured interviews, fixed chart-casting workflows, and reference-driven rules. Deterministic calendar and chart calculations are delegated to an external Python CLI script, while the LLM handles only semantic interpretation.

## Use cases
- reduce llm hallucinations in chinese astrology chart readings
- run qimen dunjia chart calculations from a python cli
- build ai skills with fixed step-by-step divination workflows
- constrain llm output with prompt rules and reference documents
- structure ai interviews to collect missing birth or event parameters
- separate deterministic computation from llm reasoning in ai assistants

## When to choose
- you want auditable, hallucination-resistant AI skills for Chinese metaphysics systems
- you need deterministic chart casting (qimen, ziwei, bazi) handled by scripts instead of LLM mental math
- you are designing defensive prompt engineering patterns for any specialized AI assistant

## When to avoid
- you need scientifically validated astrology or real-world decision advice
- you want a general-purpose divination or astrology library with rich chart rendering
- you require a licensed or formally maintained package (no license is provided)

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, prompt-engineering, cli, developer-tools, workflow-automation
- domain: artificial-intelligence, large-language-models, developer-tools
- platform: python, cli, cross-platform
- tags: chinese-astrology, qimen-dunjia, ziwei-doushu, bazi, hallucination-reduction, llm-skills, divination, structured-output, ai-agents, automation

## Member repositories
- FANzR-arch/Numerologist_skills (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:32.912196+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:48:59.673040+00:00, confidence not recorded.
  - readme: https://github.com/FANzR-arch/Numerologist_skills (fetched 2026-08-28T04:03:32.912196+00:00, sha c3c3fefab44a)
  - homepage: https://numerologist-skills.vercel.app (fetched 2026-08-29T12:50:55.783631+00:00, sha d5d980f23a93)
- Data as of 2026-08-30T08:39:29.467469+00:00.