Skip to content
Back to search

liki

Liki Skill — Professional Astrology Skill for AI assistants. BaZi, Zi Wei Dou Shu, Liu Yao, QiMen, Feng Shui, date selection and Chinese naming, powered by a deterministic engine with traceable, verifiable readings. Works in Claude, Codex, Cursor and any MCP host. Free, MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ml8s/liki with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ml8s/liki'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ml8s--liki/badge.svg)](/listings/ml8s--liki)

HTML

<a href="/listings/ml8s--liki"><img src="/api/listings/ml8s--liki/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add ml8s/liki

Installing via `npx` requires Node.js; the skill itself has no local Node.js runtime dependency. It talks to hosted MCP endpoints (`engine-mcp` for charts, `counsel-mcp` for readings) — no API keys, no configuration. Prefer no terminal? Charting is free at [liki.hk](https://liki.hk). Update when prompted:

npx skills add ml8s/liki -y

Works in Claude Code, Codex, Cursor, WorkBuddy, and any MCP-compatible assistant or IDE.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 134 lines
  1. <h1 align="center">Liki Skill</h1>
  2. <p align="center">
  3. Professional Astrology Skill.<br>
  4. For Astrology, use Liki.<br>
  5. Reproducible charts · Traceable readings · Honest boundaries<br>
  6. Bazi · Ziwei · Liuyao · QiMen · Date Selection · Feng Shui · Naming
  7. </p>
  8. <p align="center">
  9. <a href="./README.zh.md"><img alt="中文" src="https://img.shields.io/badge/中文-4a9e6b?style=flat-square"></a>
  10. <a href="./LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-4a9e6b?style=flat-square"></a>
  11. <a href="https://liki.hk"><img alt="website" src="https://img.shields.io/badge/liki.hk-6d5acf?style=flat-square"></a>
  12. </p>
  13. > Ask your AI assistant a real astrology question — a career move, a relationship, a relocation, a name — and get an answer grounded in a computed chart, not a confident guess. Liki Skill brings the liki.hk engine into Claude, Codex, Cursor and any MCP host: BaZi, Zi Wei, Liuyao, QiMen, Feng Shui, date selection and Chinese naming. Every judgment includes its factors and sources, so you can check it; if your birth hour is unclear, it calibrates against events you know. Free to install and use.
  14. ## What is Liki Skill?
  15. Liki Skill is an open-source Chinese astrology skill for AI assistants. It connects the deterministic liki.hk engine to Claude Code, Codex, Cursor, and any host that supports MCP (Model Context Protocol), covering the main systems of Chinese metaphysics: **BaZi** (Four Pillars of Destiny), **Zi Wei Dou Shu** (Purple Star astrology), **Liu Yao** (I Ching divination), **Qi Men Dun Jia** (strategy and timing), **Feng Shui**, **date selection**, and **Chinese naming**.
  16. It is not a prompt wrapper around a chatbot. Charts are cast by an astronomical engine, readings come from a rule truth table with classical sources, and unclear birth times are calibrated before any judgment — so the same question gets the same grounded answer, every time.
  17. ## Install in 30 seconds
  18. ```bash
  19. npx skills add ml8s/liki
  20. ```
  21. Installing via `npx` requires Node.js; the skill itself has no local Node.js runtime dependency. It talks to hosted MCP endpoints (`engine-mcp` for charts, `counsel-mcp` for readings) — no API keys, no configuration. Prefer no terminal? Charting is free at [liki.hk](https://liki.hk). Update when prompted:
  22. ```bash
  23. npx skills add ml8s/liki -y
  24. ```
  25. Works in Claude Code, Codex, Cursor, WorkBuddy, and any MCP-compatible assistant or IDE.
  26. ## What can you ask?
  27. | You want | Ask like this |
  28. | --- | --- |
  29. | BaZi chart reading | `Read my BaZi chart — female, born 1992-03-15 14:30 in Guangzhou` |
  30. | Career timing | `Is 2026 a good year for me to change jobs? Born 1988-07-02 in Chengdu` |
  31. | Marriage compatibility | `Check compatibility — male 1990-05-20 12:00 Beijing, female 1992-03-15 14:30 Guangzhou` |
  32. | Liu Yao divination | `Should I take this offer? Cast a Liu Yao hexagram` |
  33. | Date selection | `Which Saturday next month is good for moving house?` |
  34. | Feng shui | `My apartment faces south and was built in 2008 — how is its feng shui?` |
  35. | Chinese baby naming | `Name my baby boy — surname Chen, born 2024-06-10 in Guangzhou` |
  36. For destiny readings, provide the birth date, exact time when possible, birth city, and gender. If data is incomplete, the Skill asks follow-up questions or enters time calibration — it never silently guesses.
  37. ## Why not just ask the LLM directly?
  38. Ask a general-purpose LLM the same chart question three times and you may get three different answers. Chinese metaphysics amplifies small errors: miss a solar-term boundary by one day and the year pillar changes — every reading after it shifts.
  39. | | Ask an LLM directly | Liki Skill |
  40. | --- | --- | --- |
  41. | Charts | Mental math; solar terms and true solar time are error-prone | Astronomical engine; same input, same chart, every time |
  42. | Readings | Freeform, no sources | 829 rule truth-table assertions, each with classical sources |
  43. | Birth time | Wall-clock used as-is; boundaries silently resolved | Candidate set + reasons → per-candidate calibration; insufficient evidence labeled |
  44. | Output | Plain text | Structured JSON + SHA-256 digests, ready to build on |
  45. | Verification | None | Open source; the whole chain is auditable |
  46. ## How Liki Skill stays accurate
  47. ### Cross-checked chart engine
  48. The engine was not written once and shipped. `192` solar-term boundary cases (2024–2027, 24 terms × 2 anchors per year) are cross-checked against **lunar-python, sxtwl, and bazi-calculator** under one policy — `all_oracles_must_agree`: a single mismatch fails the gate. The Ziwei implementation aligns with iztro-compatible data. Where the engine disagreed with the classics, it was corrected against the original texts (such as Qiong Tong Bao Jian 《穷通宝鉴》) and pinned as regression anchors.
  49. ### Readings from a truth table, not improvisation
  50. Readings are not generated by the model — they are **hit** from a truth table: **829 assertions, 893 condition groups, 1,355 condition rows**, driven by 511 natal factors and 111 annual factors. A hit yields a direct conclusion with its evidence; a miss is reported as a miss. Every assertion cites its factor basis back to classical texts such as San Ming Tong Hui 《三命通会》 and Di Tian Sui 《滴天髓》. Example row:
  51. | Assertion | Basis |
  52. | --- | --- |
  53. | Five elements lack Wood: liver / gallbladder / sinews / eyes run weak | Wood governs the liver (Huangdi Neijing 《黄帝内经》: "East generates wind; wind generates wood; wood generates sour; sour generates the liver") |
  54. ### Time calibration, even with a birth certificate
  55. Clock time is not solar time: a hospital clock records standard time, while true solar time at your birthplace can drift by up to half a shichen (a traditional double-hour, about two hours). Born near a solar-term boundary, a few minutes change the year pillar; after 23:00, the late-Zi rule makes the day pillar assignment error-prone. So calibration is an explicit process:
  56. ```text
  57. your time + birthplace → normalize → candidate set (each with reasons)
  58. → full chart per candidate → compare against 2–3 real events you know
  59. → calibrated conclusion + evidence coverage; insufficient evidence is labeled
  60. ```
  61. On top of this, Mingli160 — 160 professional competition questions — is used for rule-chain coverage and zero-hit checks as a manual calibration set.
  62. ## Privacy and honest boundaries
  63. - Birth data stays in the current conversation: no profiles, no real names, no feedback payloads.
  64. - City lookup uses the built-in WGS-84 table; no external geocoding request is made.
  65. - Sensitive questions follow a support-first safety policy.
  66. - Mingli160 is a coverage and zero-hit check, not an independent accuracy benchmark.
  67. - Conclusions are conditional interpretations from a traditional cultural perspective — not medical, legal, investment, or major life advice.
  68. ## FAQ
  69. ### What is BaZi?
  70. BaZi (八字, Eight Characters), also known as the Four Pillars of Destiny, maps your birth year, month, day, and hour into four pillars of heavenly stems and earthly branches — a chart of five-element balance, ten gods, and luck cycles. Liki Skill computes this chart with an astronomical engine and reads it through 829 sourced assertions.
  71. ### Can AI do Chinese astrology accurately?
  72. A general LLM improvises; Liki Skill computes. Charts come from an astronomical engine cross-checked against three open-source implementations, and readings are emitted from a rule truth table with classical sources — every answer is reproducible and checkable.
  73. ### I do not know my exact birth hour. Can I still get a reading?
  74. Yes. The Skill asks follow-up questions or calibrates against 2–3 real events you remember, with years. If evidence is insufficient, it says so — the hour is never silently defaulted. Baby and teenage charts are read directly from the provided hour; naming uses an expected-element strategy and skips calibration.
  75. ### Does it work in Claude, Codex, or Cursor?
  76. Yes — and in any host that supports MCP. The skill ships as standard MCP tools with structured JSON output, so developers can also embed it into their own products.
  77. ### Is it free?
  78. The skill is free to install and use (`liki-free`). A paid `liki-pro` variant is delivered through the liki-mcp product endpoint for SkillHub / WorkBuddy channels, with the SkillPay / 402 payment flow.
  79. ### Is my birth data stored?
  80. No. Birth data remains in the current conversation context; it is not written to a local profile or submitted through feedback.
  81. ### How is this different from a BaZi calculator website?
  82. A calculator gives you a chart. Liki Skill gives you the chart plus sourced readings, boundary handling, and time calibration — inside the AI assistant you already use, with every conclusion traceable to its factors and classical text.
  83. ## Documentation and links
  84. - Website: [liki.hk](https://liki.hk)
  85. - Engineering source: [ml8s/liki-mingli](https://github.com/ml8s/liki-mingli)
  86. - License: MIT
  87. > For Astrology, use Liki.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.