# 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", "节气", "黄历", "农历".

- Skill name: `ccal`
- Category: [Others](https://www.openparable.com/skill/others/1)
- Source: https://github.com/x-cmd/x-cmd/blob/HEAD/mod/skill0/lib/skill0/skills/ccal/SKILL.md
- Repository: x-cmd/x-cmd (4,524 GitHub stars when collected)

## SKILL.md

# ccal — skill0

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

## Quick Start

```bash
# 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

---

Source: https://www.openparable.com/skill/others/ccal (OpenParable). Cite the canonical URL above.
