🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Korean Holiday CLI

by @chloepark85

Korean public holidays, business-day calculator, and lunar↔solar converter (CLI). Check if a date is a Korean public holiday (including 대체공휴일), list holidays...

When to Use
TriggerAction
- Is a given date a Korean public holiday? ("2026-05-05 공휴일이야?")
- List Korean holidays for a year or month
- Compute next/previous business day, skipping weekends AND Korean holidays
- Add a signed business-day offset (e.g., invoice due in +10 business days from order date)
- Count business days between two dates (payroll, SLA, delivery ETA)
- Convert solar ↔ Korean lunar dates (음력 생일 lookup, 설날·추석 date lookup)
- Render a monthly calendar view with holidays marked
Do **not** use for:
- Regional / religious holidays that aren't recognized as national public holidays (예: 성탄절 제외 종교 행사)
- Company-specific working calendars (add your own per-company overrides outside this skill)
- Realtime election-day announcements (bundled rules reflect statutory holidays; ad-hoc presidential decree holidays may lag until the `holidays` package updates)
💡 Examples

All commands are sub-commands of scripts/kr_holiday.py. Output is JSON (UTF-8, Korean preserved). Dates accept YYYY-MM-DD, YYYYMMDD, YYYY/MM/DD, or YYYY.MM.DD.

Check a date

python scripts/kr_holiday.py is-holiday 2026-05-05

→ {"date":"2026-05-05","weekday":"Tue","is_weekend":false,"is_holiday":true,"is_business_day":false,"names":["어린이날"]}

List holidays in a year (optionally filter by month)

python scripts/kr_holiday.py list --year 2026
python scripts/kr_holiday.py list --year 2026 --month 5

Next / previous business day

python scripts/kr_holiday.py next-business-day 2026-05-02                 # skip Sat → 2026-05-04 (Mon)
python scripts/kr_holiday.py next-business-day 2026-05-02 --offset 3      # 3rd next business day
python scripts/kr_holiday.py prev-business-day 2026-05-06 --offset 2

Add a signed business-day offset

python scripts/kr_holiday.py add-business-days 2026-04-20 --days 10       # 2026-05-04
python scripts/kr_holiday.py add-business-days 2026-05-05 --days -3

Count business days in a range (inclusive)

python scripts/kr_holiday.py business-days --start 2026-05-01 --end 2026-05-31

→ {"start":"2026-05-01","end":"2026-05-31","calendar_days":31,"business_days":19}

Solar ↔ Korean lunar

python scripts/kr_holiday.py solar-to-lunar 2026-02-17

→ {"solar":"2026-02-17","lunar":"2026-01-01","is_leap_month":false,"gapja":"병오년 경인월 임술일"}

python scripts/kr_holiday.py lunar-to-solar 2026-08-15 python scripts/kr_holiday.py lunar-to-solar 2025-06-01 --leap # pass --leap for 윤달

Monthly calendar view

python scripts/kr_holiday.py month 2026 5                   # human-readable, Sunday-first
python scripts/kr_holiday.py month 2026 5 --format json     # weeks grid in JSON

View on ClawHub
TERMINAL
clawhub install kr-holiday-cli

🧪 Use this skill with your agent

Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

🔍 Can't find the right skill?

Search 60,000+ AI agent skills — free, no login needed.

Search Skills →