← Back to Skills Marketplace
Zhongguo Nongli Huangli Jixiong
by
Leocdchina
· GitHub ↗
· v1.3.9
· MIT-0
336
Downloads
1
Stars
1
Active Installs
24
Versions
Install in OpenClaw
/install zhongguo-nongli-huangli-jixiong
Description
黄历查询：输入公历日期，查询当日黄历宜忌、吉凶、神煞、冲煞等信息，支持搬家吉日、结婚吉日、开业吉日、开工吉日择日。 黄历 · 中国农历黄历吉凶 · Zhongguo Nongli Huangli Jixiong · China Lunar Almanac Unified Huangli skill for com...
Usage Guidance
This skill appears to do exactly what it says: query a lunar almanac API. Before installing, confirm the HUANGLI_TOKEN requirement (the package metadata mistakenly states no env vars) and verify the token is obtained from the published dashboard (https://nongli.skill.4glz.com/dashboard). Limit the token's scope if possible and avoid reusing a high-privilege credential. If you plan to run the included toolkit locally, review toolkit.py (it is short and readable) and ensure outbound access to api.nongli.skill.4glz.com is acceptable. The main risk is giving any service a bearer token — only proceed if you trust the service/site and are comfortable with the stated quota and data handling.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description (黄历查询) match the included code and instructions: toolkit.py calls api.nongli.skill.4glz.com to fetch single-date, batch, and keyword search results. However, registry metadata shown at the top of the package summary lists "Required env vars: none" and "Primary credential: none" while SKILL.md and the code require HUANGLI_TOKEN (and optionally HUANGLI_BASE). This metadata mismatch is inconsistent and should be corrected by the publisher.
Instruction Scope
SKILL.md and toolkit.py limit actions to: reading HUANGLI_TOKEN and HUANGLI_BASE, converting/iterating dates, and making HTTPS requests to api.nongli.skill.4glz.com. The instructions do not request arbitrary file reads, system configuration changes, or network calls to other hosts. The code handles HTTP errors and quota responses; it does cap batching to 100 per request. The only odd runtime constraint: search ranges are clamped to 2026-01-01..2035-12-31 in code, which isn't explained in SKILL.md.
Install Mechanism
No install spec or external downloads are present; this is effectively an instruction-only skill with two small code files (Python and a wrapper bash script). No third-party packages are fetched at install time and nothing is written to unexpected system locations.
Credentials
The skill requests a single bearer token (HUANGLI_TOKEN) and an optional HUANGLI_BASE to point to the API — both are proportional to the described API-based functionality. The inconsistency is that the package metadata summary omitted these required env vars, which could mislead users into thinking no credentials are needed. Ask the publisher or registry to correct the metadata before installing.
Persistence & Privilege
The skill does not request persistent/system-level privileges, does not set always:true, and does not modify other skills or global agent settings. It only needs outbound HTTPS access to the specified API host.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zhongguo-nongli-huangli-jixiong - After installation, invoke the skill by name or use
/zhongguo-nongli-huangli-jixiong - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.9
- Version updated to 1.3.9.
- Documentation and metadata refreshed for this release.
- No functional code changes; usage instructions, quota information, and environment configuration details clarified.
v1.3.8
- Added OpenClaw environment configuration instructions for setting up HUANGLI_TOKEN in isolated sessions.
- Clarified recommended and manual methods for environment variable setup.
- No changes to functionality or API—documentation update only.
v1.3.7
name 改以黄历开头，兼顾农历搜索
v1.3.6
description 第二行以黄历开头，强化中文keyword密度
v1.3.5
Sync auth model docs to long-lived access token mode (no refresh endpoint required), keep slug/display name unchanged, and refresh CLI/dashboard guidance plus error semantics in references.
v1.3.4
- Updated the skill description to clarify supported queries, including specifics on daily almanac, auspicious/inauspicious activities, and feature highlights such as selecting days for moving, weddings, or business openings.
- No code changes; documentation only.
- New description improves clarity for end users on what can be queried and how the skill can be used.
v1.3.3
- Updated SKILL.md to version 1.3.3.
- Refreshed and expanded tag list for better discoverability (added tags like "nongli", "lunar almanac", "黄历吉凶").
- Updated description and tags to include more relevant keywords and improve clarity.
- No functional or code changes; documentation and metadata update only.
v1.3.2
- CLI authentication script (auth.py) removed; now only environment variable-based authentication is supported.
- Documentation (SKILL.md) streamlined: CLI usage and shell export instructions removed, with simplified environment variable setup.
- Added _meta.json metadata file for improved skill configuration.
- Slight changes to examples and instructions for usage of toolkit.py.
- Skill manifest updated with tags and fixed metadata fields.
v1.3.1
Security hardening: auth.py no longer modifies shell profiles and no longer writes token/env files by default; now prints explicit session exports only. Updated SKILL.md runtime transparency to match actual behavior.
v1.3.0
Improve scanner compatibility: add explicit required_environment_variables metadata while preserving required_env/optional_env/config_paths transparency fields.
v1.2.9
Publish governance update: enforce release rules for metadata transparency and post-publish verification for skill-related documentation changes.
v1.2.8
Fix registry transparency mismatch by declaring required_env, optional_env, and config_paths in frontmatter (HUANGLI_TOKEN, HUANGLI_BASE, ~/.huangli_token.json, ~/.huangli.env, ~/.zshrc behavior).
v1.2.7
Fix transparency mismatch: explicitly declare required env usage and default credential file writes (~/.huangli_token.json, ~/.huangli.env) in skill metadata and docs.
v1.2.6
Make install docs fully procedural: explicit per-client command steps (ClawHub and GitHub sparse-clone flows), remove ambiguous wording.
v1.2.5
Replace manual copy guidance with client-specific GitHub command install flows (sparse clone + copy), while keeping ClawHub install path for supported clients.
v1.2.4
Clarify canonical command usage to avoid path confusion: recommend python3 skills/zhongguo-nongli-huangli-jixiong/{auth.py,toolkit.py} from any directory; keep short commands only as in-folder equivalents.
v1.2.3
Normalize all installation/docs commands to published slug path: use clawhub install zhongguo-nongli-huangli-jixiong and run scripts from skills/zhongguo-nongli-huangli-jixiong/.
v1.2.2
Updated user-facing mode titles. Renamed CLI mode to emphasize the agent-first path: 中文为“CLI 模式（一切交给Agent）”，英文为 “CLI mode (let the agent handle everything)”.
v1.2.1
Clarified web mode vs CLI mode with separate full steps. Fixed metadata consistency around required env vars and included scripts. Explicitly documented local file persistence (~/.huangli_token.json, ~/.huangli.env) and that ~/.zshrc is only modified when --append-zshrc is used.
v1.2.0
Added secure CLI device authorization helper, status command, and user-focused installation/auth docs. Clarified that logout and device unbinding must be done in the web dashboard.
Metadata
Frequently Asked Questions
What is Zhongguo Nongli Huangli Jixiong?
黄历查询：输入公历日期，查询当日黄历宜忌、吉凶、神煞、冲煞等信息，支持搬家吉日、结婚吉日、开业吉日、开工吉日择日。 黄历 · 中国农历黄历吉凶 · Zhongguo Nongli Huangli Jixiong · China Lunar Almanac Unified Huangli skill for com... It is an AI Agent Skill for Claude Code / OpenClaw, with 336 downloads so far.
How do I install Zhongguo Nongli Huangli Jixiong?
Run "/install zhongguo-nongli-huangli-jixiong" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Zhongguo Nongli Huangli Jixiong free?
Yes, Zhongguo Nongli Huangli Jixiong is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Zhongguo Nongli Huangli Jixiong support?
Zhongguo Nongli Huangli Jixiong is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Zhongguo Nongli Huangli Jixiong?
It is built and maintained by Leocdchina (@leocdchina); the current version is v1.3.9.
More Skills