Installs into .claude/skills of the current project.
Are you the author of Ccal?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/thiagofernandes1987-create-ccal)
---
name: ccal
description: Chinese Calendar with Lunar-Solar Conversion
---
## Data
### Location
```
$___X_CMD_ROOT_DATA/ccal/data/
├── ccal-data-v0.0.6.tar.xz # Main archive (stream-read, not extracted)
└── v0.0.6/cache/ # Pre-extracted index (after first run)
├── year.tsv # Year index
└── month.tsv # Month index
```
### Download
- **URL**: https://codeberg.org/x-cmd/ccal-data/releases/download/v0.0.6/ccal-data.tar.xz
- **Trigger**: First run or `x ccal lunar update`
## Archive Contents
```
ccal-data/
├── index/
│ ├── year.tsv # Year index
│ └── month.tsv # Month index
└── lunar/
└── {year}_{month}.tsv # Monthly data (e.g., 2026_03.tsv)
```
## Direct Read (No Extraction)
Use `x zuz cat <archive> <path>` to stream-read from archive:
```bash
DATA="$___X_CMD_ROOT_DATA/ccal/data/ccal-data-v0.0.6.tar.xz"
# Read year index
x zuz cat "$DATA" ccal-data/index/year.tsv
# Read month index
x zuz cat "$DATA" ccal-data/index/month.tsv
# Read specific month: 2026 March
x zuz cat "$DATA" ccal-data/lunar/2026_03.tsv
# Read all months of 2026
x zuz cat "$DATA" ccal-data/lunar/2026_*.tsv
```
## Cached Read (After First Run)
```bash
CACHE="$___X_CMD_ROOT_DATA/ccal/data/v0.0.6/cache"
# Use cached index if available
[ -f "$CACHE/year.tsv" ] && cat "$CACHE/year.tsv"
```
## Reference
- `lib/awk/lunar.awk` - Lunar calendar computation
- `lib/awk/gongli.awk` - Gregorian calendar computation
- `lib/awk/ccal.awk` - Main calendar logic
