calendar-planner-cn

What This Skill Does

The calendar-planner-cn skill acts as an authoritative reference engine for the Chinese traditional calendar system. It provides comprehensive technical documentation and data references regarding the lunisolar calendar (农历), the solar terms (二十四节气), and the sexagenary cycle (干支纪年). Unlike standard calendar applications, this skill functions as a domain-specific knowledge base, delivering logic, rules, and mathematical standards governing timekeeping in Chinese culture without requiring any external internet connectivity.

Installation

To install this skill, use the OpenClaw CLI tool in your terminal:

clawhub install openclaw/skills/skills/bytesagain/calendar-planner-cn

Once installed, the skill resides locally within your environment, providing instant access to documentation via the calendar-planner-cn namespace commands.

Use Cases

• Cultural Research: Developers building localized applications can use this to understand the astronomical "Dingqi" (定气法) method for solar term calculation.
• Algorithmic Verification: Use the performance and troubleshooting commands to verify the logic behind Gregorian-to-Lunar date conversions or to debug leap month (闰月) logic in existing codebases.
• Education: Teachers and students can utilize the cheatsheet to study the sexagenary cycle, stem-branch pairings, and the historical impact of the lunisolar calendar on traditional agriculture.
• Data Standardization: Organizations needing consistent references for traditional holidays and historical dates can utilize the standards command to align with 紫金山天文台 (Purple Mountain Observatory) protocols.

Example Prompts

1. "@calendar-planner-cn intro: Explain the fundamental principles of how the lunar month is reconciled with the solar year."
2. "@calendar-planner-cn cheatsheet: Show me the stem-branch sequence and how it maps to the current lunar year."
3. "@calendar-planner-cn troubleshooting: Why do leap months occasionally create discrepancies in traditional calendar implementations?"

Tips & Limitations

• No Real-Time Clock: This skill is a reference tool. It does not track your current time or serve as a personal alarm clock or task manager.
• Local-Only: Because this skill operates entirely via heredoc and internal documentation, it does not connect to external servers. It is highly reliable, fast, and privacy-focused.
• Accuracy: The skill is based on standard astronomical models. For historical dates prior to significant calendar reforms, users should verify output against archival astronomical records.
• Professional Advice: While accurate for documentation, ensure that any mission-critical financial or legal date calculations undergo separate auditing processes.