Tung Shing Almanac Skill banner
yonlandwu yonlandwu

Tung Shing Almanac Skill

Development community

Description

Chinese almanac skill & free API — plan weddings, moves, business openings, contract signings with auspicious dates (择日), lucky hours (吉时), hour pillars & horoscopes. For Claude Code / Codex / OpenClaw / MCP. 中国黄历择日技能包 — 嫁娶搬家开业签约择吉日,免费 API。

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Tung Shing Almanac Skill (通勝黄历)

[![Install with Smithery](https://smithery.ai/badge/@yonlandwu/chinese-almanac-mcp)](https://smithery.ai/servers/yonlandwu/chinese-almanac-mcp) [![npm version](https://img.shields.io/npm/v/chinese-almanac-mcp.svg)](https://www.npmjs.com/package/chinese-almanac-mcp)

📦 Also ships as an npm MCP server: `npx -y chinese-almanac-mcp` · [MCP repo →](https://github.com/yonlandwu/chinese-almanac-mcp)

A Claude Code / Codex / OpenClaw / WorkBuddy skill that queries the [12Zodiacs.com Chinese Almanac API](https://www.12zodiacs.com/about-us/api/) — free, no API key needed for ±90 days.

**🌐 About the project** — this skill is the open-source client of the [Tung Shing engine](https://www.12zodiacs.com/tung-shing/) at 12Zodiacs.com:

  • Today's Almanac — the full web app: daily almanac, month calendars, auspicious-date topics, festival dates, and an embedded AI prompt builder
  • Methodology — how the engine computes: JPL DE440s ephemeris, the 1739 imperial canon, four-tier spirit arbitration, and validation against mainstream almanacs

**What you get**: your AI agent can plan real-life events — the best dates for weddings, moving house, business launches, contract signings, car / home purchases, renovations, C-sections, travel, and new-job starts — plus daily auspicious (宜) / avoid (忌) activities, the twelve Day Officers (建除十二神), Yellow/Black Belt hour deities (黃道黑道), zodiac clash (冲煞), lunar dates, and minute-precision 24 solar terms (节气) — computed from JPL DE440s ephemeris and the 1739 imperial canon.

Install

Claude Code

git clone https://github.com/yonlandwu/tung-shing-almanac-skill.git \
  ~/.claude/skills/tung-shing-almanac

OpenClaw / WorkBuddy

git clone https://github.com/yonlandwu/tung-shing-almanac-skill.git \
  ~/.openclaw/skills/tung-shing-almanac   # or ~/.workbuddy/skills/

Claw