Ccal

Others

ccal

Ccal is an Agent Skill for general use published in the x-cmd/x-cmd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Chinese lunar calendar with solar terms, traditional holidays, and almanac. Zero barrier — use with x-cmd or any calendar library. Use for "calendar", "lunar", "Chinese calendar", "节气", "黄历", "农历".

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/x-cmd/x-cmd/blob/HEAD/mod/skill0/lib/skill0/skills/ccal/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ccal, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

ccal — skill0

Chinese calendar: lunar dates, solar terms (节气), traditional holidays, and daily almanac (黄历宜忌).

Quick Start

# With x-cmd
x ccal                      # Interactive calendar view
x ccal info                 # Today's detailed info
x ccal info --yml 2026-05-31  # Specific date in YAML
x ccal fzm                  # Monthly solar terms and holidays

# Without x-cmd — use any Chinese calendar library
# Python: zhdate, lunardate, borax
# JS: lunar-javascript

What's Available

Feature	Description
Lunar dates	公历↔农历转换
Solar terms	24 节气查询
Holidays	传统节日、公历假日
Almanac	黄历宜忌、干支纪年
Zodiac	生肖、星座

Output Formats

Supports structured output for AI agents:

--yml YAML format
--tsv Tab-separated
--csv CSV format
--json JSON format

This skill0 grows

Starting with the essentials. Will add:

Calendar calculation algorithms
Holiday detection rules
Almanac data sources