A precise utility for converting Gregorian calendar dates into traditional Chinese Lunar Calendar formats including solar terms and zodiac signs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 1lunar
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install 1lunar using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is 1lunar?
1lunar is a specialized utility designed for Openclaw Skills that allows AI agents to perform complex conversions between the Gregorian calendar and the Chinese Lunar Calendar. By leveraging the chinese-lunar-calendar library, this skill enables developers to integrate cultural and traditional date tracking into their workflows. It provides deep metadata beyond simple date mapping, including the Gan-Zhi year cycle, leap month identification, and solar term detection, making it an essential component for applications targeting users who follow traditional Chinese schedules.
1lunar Use Cases
- Determining the lunar date for any given current or historical Gregorian date.
- Calculating the specific Gregorian dates for traditional festivals like the Spring Festival, Dragon Boat Festival, and Mid-Autumn Festival.
- Identifying the Chinese zodiac animal associated with a specific birth year.
- Checking for specific Solar Terms (Jieqi) to align with agricultural or cultural cycles.
How 1lunar Works
- The AI agent processes a user request involving a specific date or traditional Chinese holiday.
- The skill executes a Node.js script using the installed chinese-lunar-calendar dependency.
- The getLunar function is called with the target year, month, and day as arguments.
- The library calculates the lunar mapping and returns a detailed data object.
- The agent parses this object to provide a human-readable response regarding the lunar date and associated cultural markers within Openclaw Skills.
1lunar Setup
To enable this skill, you must first install the necessary npm package in your environment:
cd /tmp && npm install chinese-lunar-calendar
You can then test the functionality using a Node.js one-liner:
node -e "const { getLunar } = require('/tmp/node_modules/chinese-lunar-calendar/src/lunar_calendar.js'); console.log(getLunar(2024, 1, 15));"
1lunar Data Schema & Taxonomy
The 1lunar skill returns a structured object with the following metadata fields to ensure accuracy within Openclaw Skills:
| Property | Type | Description |
|---|---|---|
| lunarYear | String | The Lunar year in Gan-Zhi format (e.g., "Gui-Mao") |
| lunarMonth | String | The numeric or named lunar month |
| lunarDate | String | The day of the lunar month |
| isLeap | Boolean | Indicates if the current month is a leap month |
| zodiac | String | The animal sign associated with the year (e.g., "Rabbit") |
| solarTerm | String | Name of the solar term if the date coincides with one |
| dateStr | String | A simplified Chinese string representation of the lunar date |
1lunar Advanced Features
- Precise Gan-Zhi year cycle calculations for traditional astrology use cases.
- Automatic detection of the 24 Solar Terms for seasonal alignment.
- Support for leap month (Runyue) logic to ensure calendar accuracy over long periods.
- Low-latency execution via direct Node.js integration for Openclaw Skills automation.
SKILL.md
Loading
Related Openclaw Skills
News Scraper
A specialized tool for scraping latest AI industry news with automated summarization and built-in deduplication.
Data Analyst Partner
A Grafana-first analytical companion that bridges the gap between raw data and actionable business insights for product and operations teams.
Hello World Skill
A friendly greeting skill that responds to greetings in multiple languages and introduces the OpenClaw assistant.
CodeAlive Context Engine
A powerful semantic code intelligence engine for AI agents to search, explore, and chat with entire codebase ecosystems.
Mutinynet Faucet CLI
A CLI tool for interacting with the Mutinynet Bitcoin testnet faucet to manage on-chain and lightning network transactions.
Discussion Section Architect
A specialized AI skill designed to structure, interpret, and write high-quality academic discussion sections for research reports.
Featured*
