Liuyao Agent Skills plugin
Liuyao divination skills for agents: casting by coins, hexagram layout and a reading under school rules with limited conclusions.
- 66 ★ on the repository
- Last commit
Minimal access
Why this level
- The skills give interpretation within a tradition without scientific verification; do not base health, legal or money decisions on it.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/liuyao-agent-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skills give interpretation within a tradition without scientific verification; do not base health, legal or money decisions on it.
This is third-party code. Review the repository files before installing.
What it does
A set of two skills and layout code for the traditional Chinese divination liuyao. `liuyao-divination` runs a general reading: the topic owner, element relations, a pair of source lines and thematic assessments. `liuyao` reads a cast in layers: the time the question was set, day role, order of moving lines and false voids. The `liuyao-paipan-code` code builds the hexagram by eight palaces and derives the six relatives and six spirits, hidden lines, ten-day voids and calendar context. Versions 1.1 and 1.2 added a conclusion funnel: one main conclusion, one causal chain and one key limit; thematic ladders separate intent from outcome. Health is read only as a system state with no diagnoses, treatment or prognosis. The skills run in Claude, Codex, Cursor, Gemini, Copilot, OpenCode and other clients with the Agent Skills format.
Who it is for. Enthusiasts of the Chinese divination tradition who want a cast and a reading from an agent under school rules with clear limits on conclusions.
Good fit when
- A cast for a question with a hexagram layout and layered reading is wanted.
- A general reading of a topic is needed: work, relationships, travel or a lost item.
- The result must show one main conclusion and the key limit.
- One rule set has to be installed into several agents at once.
Not a fit when
- Medical, legal or investment decisions are at stake: the skill only gives a tradition-based interpretation.
- A verifiable forecast is required: divination has no scientific basis.
- A Russian-language set is needed: the instructions are written in Chinese.
Example request
Read a liuyao cast for a job change question: show the hexagram, the main conclusion and one limit.Limitations
The skills give an interpretation within a divination tradition that is unverifiable and does not replace a doctor, lawyer or financial adviser. Version 1.2 forbids deriving diagnoses, recovery prognosis and prices from a cast and limits market questions to states and conditions. Python 3.10 is needed for the installer, and instructions and texts are written in Chinese. The two skills keep separate rules and do not mix by default. The last commit is dated 9 September 2026.
How to disable. Delete the `liuyao` and `liuyao-divination` folders from the agent skills directory (the installer places them in the user directories of the chosen clients). Delete the cloned repository separately.
FAQ
Which agents are supported?
Claude, ChatGPT, Codex, WorkBuddy, Cursor, Gemini, GitHub Copilot, OpenCode, Windsurf, Cline and other clients with the Agent Skills format. Others use the open directory or a custom path.
How do the two skills differ?
`liuyao-divination` runs a general reading with dual roots and balancing, while `liuyao` reads a cast by layers of time and the order of moving lines. Rules of one do not leak into the other.
What may not be derived from a cast?
Version 1.2 does not allow deriving diagnoses, treatment, prognosis, prices or final profit. For health and markets only states and conditions remain.
How do I install into one project?
Run `python3 scripts/install.py --agent cursor --scope project --target /path/to/project`. For all clients user directories use `--agent all --scope user`.
What is the layout code for?
`liuyao-paipan-code` builds the hexagram by eight palaces and derives the six relatives, six spirits, hidden lines, voids and calendar context so the agent does not compute by hand.
Discussion
No questions or reviews yet.
Related
PluginsA skill for BaZi charts and related systems: true solar time, compatibility, date selection and a report citing the classics
Three Chinese divination skills: a script computes the Qimen Dunjia and Ziwei Doushu charts, then the agent interprets. Bazi is included
A Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.
Ten Chinese-language skills for Claude Code, Codex and OpenClaw: Vibe Coding from idea to code, topic learning, video downloads.
A skill that computes Bazi and Zi Wei Dou Shu charts by algorithm, then the model reads the result and builds an HTML poster.
The author's personal skills for reading papers and books, dissecting concepts, writing and PNG cards; instructions in Chinese, installed via skills CLI
README in short
The README describes a shared package for various agents, two skills with separate rules and the history of versions 1.1 and 1.2 with new limits on conclusions.