jisu-huangli

What This Skill Does

The jisu-huangli skill is a specialized agent capability designed to provide comprehensive Chinese calendar (Huangli) information. It integrates with the JisuAPI platform to offer detailed daily insights, including Gregorian and Lunar calendar mapping, zodiac signs, constellations, auspicious and ominous activities (Yi and Ji), elemental data (Wuxing), and traditional directional deities (Caishen, Xishen). The skill provides a robust dataset covering a wide range of dates from 1900 to 2100, making it an essential tool for users seeking to align their plans with traditional cultural or astrological guidelines.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jisuapi/huangli

Ensure you have obtained a valid API Key from JisuAPI. You must set this key as an environment variable in your system before execution:

• Linux/macOS: export JISU_API_KEY="your_appkey_here"
• Windows PowerShell: $env:JISU_API_KEY="your_appkey_here"

Use Cases

• Cultural Planning: Determining auspicious dates for significant events like weddings, relocations, or business openings by checking the 'Yi' (auspicious) and 'Ji' (prohibited) lists.
• Astrological Inquiry: Quickly retrieving star sign information or Chinese zodiac signs for a given birth date.
• Daily Guidance: Helping users understand the daily 'Chongsha' (directional taboos) and the positioning of deities to assist in daily decision-making.
• Academic or Personal Research: Accessing precise calendar data spanning two centuries to analyze historical or future dates from a traditional Chinese astronomical perspective.

Example Prompts

1. "帮我看看 2025 年 5 月 20 日黄历如何，这一天适合结婚登记吗？"
2. "查询一下 1995 年 8 月 15 日出生的农历日期、生肖以及对应的星座。"
3. "今天适合搬家吗？帮我查一下今日的忌讳和财神方位。"

Tips & Limitations

• Data Integrity: The skill depends entirely on the JisuAPI uptime and rate limits; ensure your API Key is active to avoid 104 (rate limit exceeded) or 101 (key missing) errors.
• Date Accuracy: Always ensure the input date format (year, month, day) is valid; the API will return a 201 error if the date does not exist (e.g., February 30th).
• Interpretation: While the skill provides objective data like 'Yi' and 'Ji', please remember that these are traditional cultural guidelines. Use the information as a reference rather than an absolute indicator of success or failure for any real-world activity.
• Privacy: As this skill interacts with an external API, ensure you do not transmit sensitive personal identifiers along with the request, only the necessary calendar date integers.