Agent skill

Lunar Calendar

by rongxinzy in rongxinzy/RongxinAI

中国农历/阴历的专业查询工具. An agent skill from rongxinzy/RongxinAI.

AGPL-3.0Auto-check passed

Install Lunar Calendar

skills CLI
$ npx skills add rongxinzy/RongxinAI --skill lunar-calendar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rongxinzy/RongxinAI lunar-calendar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/lunar-calendar .claude/skills/lunar-calendar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lunar-calendar
GitHub stars
154
Used in
1 other repo
Token cost
~538 tokens
SKILL.md length
51 words
Files
8 (incl. scripts, references)
Skills in repo
94
Repo updated
First seen
Licence
AGPL-3.0

At a glance

中国农历/阴历的专业查询工具. An agent skill from rongxinzy/RongxinAI.

  • Works in 4 steps: 禁用模糊表述:如"大概是"、"我记得农历好像是"。农历是精确历法,必须输出确定结果。 → 闰月处理:输出农历月时必须显式标注"闰"字(如"闰七月"),脚本已内置判别逻辑。 → 时间范围:本技能支持1900-2100年(脚本算法覆盖范围),超出需提示用户。 → …
  • SKILL.md covers 🎯 Purpose, ⏰ When to Use, 🧠 Process (低自由度·严格模式) and 🔍 Decision Logic, plus 1 more section
  • Runs Python scripts from its folder; calls python

What it does

Lunar Calendar is an agent skill from rongxinzy/RongxinAI. 中国农历/阴历的专业查询工具。 核心能力: - 公历转农历(干支纪年、生肖、闰月标志) - 农历转公历(支持闰月精准转换) - 黄历宜忌查询(嫁娶、动土、开市等) - 节气查询(24节气精准到秒级) 触发场景:当用户询问"农历"、"黄历"、"宜忌"、"阴历"、"八字基础"、"春节日期"、"闰月"或需要处理中国传统历法计算时强制激活。 输出物:结构化日期信息 + 宜忌表 + 节气标识。

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `lunar_calendar.py`, `references/fortune_rules.md` and `references/solar_terms.md`).

The repository describes itself as: An all-in-one local AI Agent workspace with a fully self-developed stack. The licence is AGPL-3.0.

Example prompts

  • “/lunar-calendar”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 禁用模糊表述:如"大概是"、"我记得农历好像是"。农历是精确历法,必须输出确定结果。
  2. 闰月处理:输出农历月时必须显式标注"闰"字(如"闰七月"),脚本已内置判别逻辑。
  3. 时间范围:本技能支持1900-2100年(脚本算法覆盖范围),超出需提示用户。
  4. 黄历输出:仅输出传统历书规定的宜忌项,不添加现代演绎内容(如"宜发朋友圈")。

What it can do on your machine

Read from SKILL.md and the folder at commit 9c64865. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lunar Calendar loads about 538 tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 51 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~538
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from rongxinzy/RongxinAI at commit 9c64865, republished under its AGPL-3.0 licence (© rongxinzy). 51 words, ~538 tokens.

Download SKILL.mdSave it as .claude/skills/lunar-calendar/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
lunar-calendar
description
中国农历/阴历的专业查询工具。 核心能力: - 公历转农历(干支纪年、生肖、闰月标志) - 农历转公历(支持闰月精准转换) - 黄历宜忌查询(嫁娶、动土、开市等) - 节气查询(24节气精准到秒级) 触发场景:当用户询问"农历"、"黄历"、"宜忌"、"阴历"、"八字基础"、"春节日期"、"闰月"或需要处理中国传统历法计算时强制激活。 输出物:结构化日期信息 + 宜忌表 + 节气标识。

<skill_body>

🎯 Purpose

提供精确到秒级的中国传统农历(夏历)转换与查询服务。本技能是确定性计算任务,严禁依赖大模型内部参数化的农历记忆(该记忆存在闰月错位风险),必须通过脚本执行可靠算法。

⏰ When to Use

  • ✅ 用户输入中包含"农历"、"阴历"、"黄历"、"宜忌"、"干支"、"生肖"、"节气"
  • ✅ 需要将公历日期转换为"乙巳年、正月十五"等中式表述
  • ✅ 需要判断某日是否"宜嫁娶"、"忌开市"
  • ✅ 查询二十四节气的具体交节时刻
  • ❌ 用户仅询问"今天是几号"(请留给通用对话能力)

🧠 Process (低自由度·严格模式)

步骤1:意图识别与参数提取
  • 判断转换方向:公历→农历 / 农历→公历 / 宜忌查询
  • 提取核心参数:
    • 公历日期(如 2026-02-13)
    • 农历表述(如 二零二六年腊月廿三、闰七月)
    • 具体需求(仅日历/仅宜忌/详细解读)
步骤2:调用专用脚本(严禁自行编写)

<critical_rule status="最高优先级"> 你不得尝试用Python代码现场计算农历。农历涉及复杂置闰规则和定朔算法,运行时现场编写的代码存在计算错误风险。 你必须直接调用 scripts/lunar_calculator.py。 </critical_rule>

  • 调用格式示例:
bash
python scripts/lunar_calculator.py --solar 2026-02-13
python scripts/lunar_calculator.py --lunar "2026-07-23" --leap false
python scripts/lunar_calculator.py --solar 2026-02-13 --with-fortune true
步骤3:按需加载参考资源
  • 如需输出"详细宜忌解读",必须先读取 references/fortune_rules.md
  • 如需解释"节气原理",读取 references/solar_terms.md
  • 严禁将上述Reference全文塞入上下文,仅读取所需章节。
步骤4:结构化组装输出

强制使用以下固定模板,禁止自由发挥格式:

xml
<lunar_query_result>
<solar_date>{{输入或计算出的公历日期}}</solar_date>
<lunar_date>
  <year>{{干支年}}({{生肖}})</year>
  <month>{{农历月}}{{闰月标识}}</month>
  <day>{{农历日}}</day>
  <festival>{{若有传统节日}}</festival>
</lunar_date>
<solar_term>{{节气名称}}({{交节时间}})</solar_term>
<fortune>
  <suitable>{{宜:条目1、条目2}}</suitable>
  <avoid>{{忌:条目1、条目2}}</avoid>
</fortune>
</lunar_query_result>

🔍 Decision Logic

mermaid
graph TD
A[用户输入] --> B{包含农历/黄历关键词?}
B -->|否| C[不激活技能]
B -->|是| D{具体请求类型?}
D -->|公历转农历| E[提取日期→调用lunar_calculator.py --solar]
D -->|农历转公历| F[解析农历字符串→调用lunar_calculator.py --lunar]
D -->|查询宜忌| G[调用脚本+读取fortune_rules.md]
E --> H[组装XML输出]
F --> H
G --> H

⚠️ Constraints(防走偏)

  1. 禁用模糊表述:如"大概是"、"我记得农历好像是"。农历是精确历法,必须输出确定结果。
  2. 闰月处理:输出农历月时必须显式标注"闰"字(如"闰七月"),脚本已内置判别逻辑。
  3. 时间范围:本技能支持1900-2100年(脚本算法覆盖范围),超出需提示用户。
  4. 黄历输出:仅输出传统历书规定的宜忌项,不添加现代演绎内容(如"宜发朋友圈")。 </skill_body>

© rongxinzy, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/lunar-calendar of rongxinzy/RongxinAI.

  • SKILL.md
  • lunar_calendar.py
  • references/fortune_rules.md
  • references/solar_terms.md
  • scripts/demo_lunar.py
  • scripts/lunar_calculator.py
  • scripts/simple_validator.py
  • scripts/validate_lunar.py

Open the folder on GitHubat commit 9c64865

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in rongxinzy/RongxinAI, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Lunar Calendar next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lunar Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lunar Calendar this skillrongxinzy/RongxinAI1541 repos~538Automated safety check: PassAGPL-3.0
Google Calendarcodewhale-hq/Codewhale41k—~512Automated safety check: PassMIT
Team Calendarsickn33/agentic-awesome-skills47k1 repos~3.3kAutomated safety check: PassMIT
Gws Calendar Agendagoogleworkspace/cli31k1 repos~389Automated safety check: PassApache-2.0
Feishu Calendar Managerop7418/CodePilot6.5k1 repos~1.4kAutomated safety check: PassCustom licence
WeCom Calendar SchedulerWecomTeam/wecom-cli3.2k1 repos~3.7kAutomated safety check: PassMIT

Similar skills

  • Google Calendar

    codewhale-hq/Codewhale

    Reads schedules, checks free and busy time, and creates or updates Google Calendar events through the Calendar API, with care around invites and recurring series.

    41k GitHub stars~512 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Team Calendar

    sickn33/agentic-awesome-skills

    Team calendar: event, type, date and time with time zone, attendees, organizer, location and source module.

    47k GitHub starsUsed in 1 repo~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Gws Calendar Agenda

    googleworkspace/cli

    Google Calendar: Show upcoming events across all calendars. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~389 tokens
    Documents & OfficeAuto-check passed
  • Feishu Calendar Manager

    op7418/CodePilot

    Tool guidance for Feishu calendars: creating, listing, updating and searching events, managing attendees and replies, and checking free and busy time.

    6.5k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • WeCom Calendar Scheduler

    WecomTeam/wecom-cli

    Books, views, searches, updates, cancels or checks free/busy time on WeCom (Enterprise WeChat) calendars and meeting rooms, routed away from online-meeting creation.

    3.2k GitHub starsUsed in 1 repo~3.7k tokens
    Productivity & AutomationAuto-check passed
  • Dingtalk Calendar

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉日历与会议室。Use when 用户说 约会议/查日程/订会议室/查闲忙/加参会人/改期/取消会议/今天的日程/本周日程/共同空闲。不做视频会议发起/邀请入会/会中控制(走 dingtalk-misc)、AI 听记(走 dingtalk-minutes)、待办任务(走 dingtalk-todo)。命令前缀:dws calendar。

    3.2k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

More from rongxinzy/RongxinAI

All 94 skills in this repo
  • SaaS Metrics Coach

    rongxinzy/RongxinAI

    SaaS financial health advisor. An agent skill from rongxinzy/RongxinAI.

    154 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Churn Prevention

    rongxinzy/RongxinAI

    Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.

    154 GitHub starsUsed in 3 repos~2.6k tokens
    Auto-check passed
  • Presentation Studio

    rongxinzy/RongxinAI

    The only skill for creating a new PowerPoint deck. An agent skill from rongxinzy/RongxinAI.

    154 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Zhiyuan Expert Manager

    rongxinzy/RongxinAI

    ZhiYuan Agent expert package lifecycle manager for the pi engine.

    154 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Ziwei Doushu

    rongxinzy/RongxinAI

    Professional Ziwei Doushu consultation skill with an offline calculation engine.

    154 GitHub stars~746 tokensUpdated yesterday
    Auto-check passed
  • Lark Mail

    rongxinzy/RongxinAI

    飞书邮箱:Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等;use for mail/email intent only.

    154 GitHub starsUsed in 3 repos~4.1k tokens
    Auto-check: warnings

Questions about Lunar Calendar

What does Lunar Calendar do?

中国农历/阴历的专业查询工具. An agent skill from rongxinzy/RongxinAI. Lunar Calendar is an agent skill from rongxinzy/RongxinAI.

How do I install Lunar Calendar in Claude Code?

Run `npx skills add rongxinzy/RongxinAI --skill lunar-calendar -a claude-code`. Or copy the skill folder (SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/lunar-calendar in rongxinzy/RongxinAI) into .claude/skills/lunar-calendar in your project. Claude Code loads it when a task matches its description.

How do I install Lunar Calendar in Codex?

Run `npx skills add rongxinzy/RongxinAI --skill lunar-calendar -a codex`. Or copy the skill folder (SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/lunar-calendar in rongxinzy/RongxinAI) into .agents/skills/lunar-calendar in your project. Codex loads it when a task matches its description.

Can I use Lunar Calendar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rongxinzy/RongxinAI --skill lunar-calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lunar-calendar, .gemini/skills/lunar-calendar, .github/skills/lunar-calendar and .opencode/skills/lunar-calendar in your project.

What does Lunar Calendar need to run?

Going by SKILL.md and its folder, Lunar Calendar needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Lunar Calendar access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Lunar Calendar safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Lunar Calendar use?

Lunar Calendar is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lunar Calendar use?

About 538 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Lunar Calendar?

Skills that share tags, products or a category with Lunar Calendar: Google Calendar (codewhale-hq/Codewhale, 41k stars), Team Calendar (sickn33/agentic-awesome-skills, 47k stars), Gws Calendar Agenda (googleworkspace/cli, 31k stars) and Feishu Calendar Manager (op7418/CodePilot, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lunar Calendar?

rongxinzy (a GitHub organization) maintains it in rongxinzy/RongxinAI, which has 154 GitHub stars. The repository holds 94 skills in this directory. The repository was last updated on October 10, 2026.

Source: rongxinzy/RongxinAI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.