ccal

Installation
SKILL.md

ccal - Chinese Lunar Calendar

The ccal module is a terminal calendar specifically designed for users interested in the Chinese lunar calendar. It provides lunar dates, solar terms, and information about traditional festivals and daily fortune (Huangli).

When to Activate

  • When the user wants to see the current or a specific date's lunar info.
  • When checking solar terms, public holidays, or makeup work days in China.
  • When viewing traditional festival dates or zodiac information interactively.

Core Principles & Rules

  • Interactive Browsing: Use fz subcommands for a searchable TUI experience.
  • Detailed Info: Use the info subcommand for a comprehensive breakdown of a single day (lunar, stems-and-branches, etc.).
  • Localization: Supports customizing weekday naming (e.g., using "礼拜" vs "星期").

Patterns & Examples

Today's Lunar Info

# View detailed lunar and traditional info for today
x ccal info

Specific Date

# Check lunar info for a future date
x ccal info 2025-5-20

Interactive Year View

# Browse traditional festivals and zodiacs interactively for the year
x ccal fzy

Checklist

  • Confirm if the user needs info for today or a specific date.
  • Verify if an interactive view or a simple data output is preferred.
Related skills

More from x-cmd/skill

Installs
3
Repository
x-cmd/skill
GitHub Stars
20
First Seen
Apr 10, 2026