← Back to Skills Marketplace
31
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install chinese-almanac
Description
Chinese Almanac (Xie Ji Bian Fang Shu) — Classical date selection system based on the Qing Dynasty imperial almanac. Calculate auspicious dates for marriage,...
README (SKILL.md)
Chinese Almanac (古典择日 / 中国暦)
A classical Chinese date selection system based on the Qing Dynasty imperial almanac 《协纪辨方书》(Xie Ji Bian Fang Shu), combining multiple layers of auspicious/inauspicious analysis.
What It Does
Find the best dates for important life events using traditional Chinese metaphysics.
为人生大事选择最佳日期，融合传统中国命理学。
重要な行事に最適な日付を伝統的な中国のメタフィジクスで選定。
Core Systems (核心体系)
| System | Chinese | Description | 说明 |
|---|---|---|---|
| 12 Day Officers | 建除十二神 | Jianchu cycle: 建除满平定执破危成收开闭 | 12种日值循环 |
| Yellow/Black Road | 黄道黑道 | 6 auspicious + 6 inauspicious stars | 6吉星+6凶星 |
| Heavenly Virtue | 天德月德天赦 | Heavenly forgiveness & virtue stars | 天上吉神庇佑 |
| Pengzu Taboos | 彭祖百忌 | Daily stem/branch taboos | 天干地支禁忌 |
| Five Elements | 五行生克 | Wood/Fire/Earth/Metal/Water interactions | 五行相生相克 |
10 Activity Types (10类活动)
| Emoji | Activity | Chinese | 日本語 |
|---|---|---|---|
| 💒 | Marriage | 嫁娶 | 結婚 |
| 🏪 | Opening Business | 开业 | 開業 |
| 🏠 | Moving | 搬家 | 引越し |
| 📝 | Signing Contracts | 签约 | 契約 |
| ✈️ | Travel | 出行 | 旅行 |
| 🔨 | Renovation | 装修 | 改装 |
| 🙏 | Worship/Prayer | 祭祀 | 祈り |
| 💰 | Seeking Wealth | 求财 | 金運 |
| 👔 | Starting New Job | 上任 | 就任 |
| 💍 | Engagement | 订婚 | 約束 |
CLI Usage
cd scripts && npm install
node cli.js 2026-06 marriage # English output
node cli.js 2026-06 marriage --lang zh # 中文输出
node cli.js 2026-06 marriage --lang ja # 日本語出力
node cli.js best 2026-06 marriage # Find best date
node cli.js --json 2026-06 marriage # JSON output
Output Includes
| Feature | Description | 说明 | 説明 |
|---|---|---|---|
| Day Officer | 建除十二神 value | 日值 | 日の値 |
| Yellow/Black Road | Auspicious star | 黄道黑道 | 黄道黒道 |
| Heavenly Virtue | Virtue stars present | 天德月德 | 天徳月徳 |
| Pengzu Taboo | Stem/branch warnings | 彭祖百忌 | 彭祖百忌 |
| Auspicious Score | 0-10 rating | 吉祥评分 | 吉祥スコア |
| Do/Don't Lists | What to do/avoid | 宜忌 | 宜忌 |
| Best Hours | Auspicious time periods | 吉时 | 吉時 |
Triggers (触发词)
- English: almanac, chinese calendar, auspicious date, date selection, pick a good day
- 中文: 择日, 择吉, 选日子, 黄道吉日, 黄历, 古典择日, 协纪辨方书, 结婚日子, 开业日子, 搬家日子
- 日本語: 中国暦, 時計, 吉日, 日取り, 中国暦選日
Notes
- Based on 《协纪辨方书》(Xie Ji Bian Fang Shu), Qing Dynasty imperial almanac
- Combines 5 traditional Chinese metaphysics systems
- Entertainment purposes — not a substitute for professional advice
- 基于清乾隆钦定《协纪辨方书》，融合五大传统命理体系
- 清乾隆帝勅撰の暦書に基づく、5つの伝統中国メタフィジクスを融合
Usage Guidance
Install only if you want traditional Chinese almanac-style date selection. Be aware that some trigger terms are overly broad or mistranslated, so the skill may activate for ordinary scheduling or Japanese timepiece-related requests until those triggers are narrowed.
Capability Assessment
Purpose & Capability
The artifacts consistently describe and implement auspicious-date calculations for marriage, moving, business, travel, and related events using static local rules and i18n data.
Instruction Scope
The trigger wording includes broad phrases like "pick a good day" and the Japanese term "時計," which may cause accidental activation, but this is a routing/quality issue rather than evidence of unsafe behavior.
Install Mechanism
package.json declares no dependencies and no lifecycle install scripts; the CLI only requires the local i18n module. The README-style `cd scripts && npm install` example appears inconsistent because package.json is at the artifact root, but it does not add a security concern.
Credentials
Runtime behavior is proportionate: it performs local date calculations and console output only. Static inspection found no filesystem access, network calls, process spawning, credential access, or environment reads in executable code.
Persistence & Privilege
No persistence, background worker, privilege escalation, credential/session use, or mutation of user data is present in the artifacts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chinese-almanac - After installation, invoke the skill by name or use
/chinese-almanac - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
v1.0.0: 三语版协纪辨方书择日系统。英文+中文+日文并列描述。10类活动择日，建除十二神+黄道黑道+彭祖百忌+评分。
Metadata
Frequently Asked Questions
What is Chinese Almanac (古典择日)?
Chinese Almanac (Xie Ji Bian Fang Shu) — Classical date selection system based on the Qing Dynasty imperial almanac. Calculate auspicious dates for marriage,... It is an AI Agent Skill for Claude Code / OpenClaw, with 31 downloads so far.
How do I install Chinese Almanac (古典择日)?
Run "/install chinese-almanac" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chinese Almanac (古典择日) free?
Yes, Chinese Almanac (古典择日) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chinese Almanac (古典择日) support?
Chinese Almanac (古典择日) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chinese Almanac (古典择日)?
It is built and maintained by ikplpeter (@ikplpeter); the current version is v1.0.0.
More Skills