korean-holiday-calendar
nomadamas/k-skill
Query Korean holidays, commemorative days, and solar terms via Korea Astronomy and Space Science Institute API.
What is korean-holiday-calendar?
Reads Korean holiday and special day information from the Korea Astronomy and Space Science Institute through a proxy API. Use this to look up public holidays, national days, commemorative dates, the 24 solar terms, and minor seasonal observances for a given date range.
- Query public holidays (공휴일) and national days (국경일)
- Look up commemorative days (기념일) and observances
- Retrieve the 24 solar terms (24절기) and minor seasonal days (잡절)
- Filter results by date range
- Read-only access to official Korean astronomical calendar data
How to install korean-holiday-calendar
npx skills add https://github.com/nomadamas/k-skill --skill korean-holiday-calendar- Node.js 18 or later
- Access to run npx commands
- Internet connectivity to reach the Korea Astronomy and Space Science Institute API via k-skill-proxy
How to use korean-holiday-calendar
- 1.Run `npx -y @nomadamas/k-skill@0 instruct korean-holiday-calendar` to retrieve full runtime-specific instructions
- 2.Follow the printed instructions for your environment (Dolshoi vault/CloakBrowser or generic)
- 3.Call the API with your desired date range to query holidays and special days
- 4.Parse the returned JSON to extract holiday names, dates, and categories
- 5.Integrate the results into your application's calendar or scheduling logic
Use cases
- Display Korean holidays in a calendar application or scheduling tool
- Check which days are public holidays before planning events or meetings
- Retrieve solar term dates for traditional Korean cultural or agricultural purposes
- Populate a holiday list for payroll or HR systems that need Korean holiday data
- Build a localized calendar widget showing Korean special days
- Developers building Korean-market applications
- HR and payroll system administrators
- Calendar and scheduling application developers
- Teams working with Korean users or offices
korean-holiday-calendar FAQ
Public holidays (공휴일), national days (국경일), commemorative days (기념일), the 24 solar terms (24절기), and minor seasonal observances (잡절).
Yes, this skill only queries holiday information; it does not modify or create data.
A proxy service that routes requests to the Korea Astronomy and Space Science Institute API, handling authentication and request formatting.
The skill is designed for Korean holidays and observances; results for non-Korean calendars are not supported.
Run `npx -y @nomadamas/k-skill@0 update` to update the CLI and all installed skills to their latest versions.
Full instructions (SKILL.md)
Source of truth, from nomadamas/k-skill.
name: korean-holiday-calendar description: 한국천문연구원 특일 정보 API를 k-skill-proxy 경유로 호출해 공휴일·국경일·기념일·24절기·잡절을 조회한다. 조회 전용. license: MIT metadata: category: utility locale: ko-KR phase: v1
korean-holiday-calendar
<!-- k-skill:cli-stub — generated by scripts/generate-skill-stubs.js; edit skill.json / instruction.md instead -->Get the full instructions (required first step)
Run this and follow its output as the primary instructions for this skill:
npx -y @nomadamas/k-skill@0 instruct korean-holiday-calendar
The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:
npx -y @nomadamas/k-skill@0 files korean-holiday-calendar
Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with:
npx -y @nomadamas/k-skill@0 update
If npx is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/korean-holiday-calendar/instruction.md.
Hard rules even without the CLI
- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.
Related skills
More from nomadamas/k-skill and the wider catalog.
korean-humanizer
Transform AI-written Korean into natural, human-like prose by fixing translation artifacts and common AI patterns.
korean-jangbu-for
Automate Korean business accounting, tax filing, and financial reporting for startups and freelancers.
korean-law-search
Search Korean statutes, articles, precedents, interpretations, and local ordinances.
korean-marathon-schedule
查询韩国马拉松和铁人三项赛事日程、地点、报名截止日期和项目信息。
korean-middle-korean
Convert modern Korean text into archaic Middle Korean style with historical particles, endings, and Hanja hints.
korean-patent-search
Search Korean patents and utility models via KIPRIS Plus Open API with keyword and application-number lookup.