lunar-calendar

What This Skill Does

The lunar-calendar skill provides a highly accurate, deterministic engine for querying the Chinese traditional calendar (Xia calendar). Unlike standard LLMs that rely on probabilistic memory—which is prone to errors regarding leap months and shifting dates—this skill enforces a robust computational approach. It serves as a specialized utility for converting between Gregorian (solar) and Lunar dates, determining accurate 24 solar terms, and retrieving traditional Chinese fortune-telling data such as "Yi" (suitable) and "Ji" (avoidance) activities.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/hehuibiao/lunar-calendar

Use Cases

• Calendar Synchronization: Perfect for individuals and developers needing precise mapping between Western Gregorian dates and traditional Chinese calendar dates.
• Traditional Activity Planning: Ideal for users planning events based on traditional Chinese auspicious/inauspicious days, such as choosing dates for weddings, business openings, or construction, based on the "Huangli" (Yellow Almanac).
• Educational & Seasonal Tracking: Provides precise scientific data for the 24 solar terms, helping users track traditional agricultural and climate markers with second-level accuracy.
• Cultural & Historical Research: Supports historiography by providing reliable conversions for dates ranging from 1900 to 2100.

Example Prompts

1. "帮我查一下2026年春节对应的公历日期，顺便告诉我那天宜忌什么。"
2. "公历2025年6月1日是农历哪一天？生肖是什么？"
3. "今天是农历几月几号？今年有没有闰月？"

Tips & Limitations

• Accuracy First: The skill operates in a "strict mode" and is strictly forbidden from hallucinating or guessing dates. It uses an internal Python calculation script to ensure data integrity.
• Scope: The current implementation supports dates between 1900 and 2100. Queries outside this range will return a notification that the date is unsupported.
• Structure: Output is always provided in a standardized XML format to ensure machine-readability for further agentic workflows.
• Focus: This skill focuses strictly on traditional calendar data. It does not provide modern interpretations or daily horoscopes, keeping its utility clean and professional.