Use when the user asks for Korean school meal menus (급식 식단) by natural-language education office and school name, via k-skill-proxy NEIS school-search and school-meal routes.
The Korean School Lunch Menu skill enables users to retrieve daily meal menus from Korean schools through the NEIS (National Education Information System) open data portal. Instead of requiring users to know complex school codes or navigate government APIs directly, this skill allows natural language queries using familiar names like "Seoul Metropolitan Office of Education" and "Future Elementary School." The skill acts as an intelligent intermediary that translates conversational requests into properly formatted API calls through the k-skill-proxy service, which securely manages the required API credentials.
The skill provides a two-step lookup process: first searching for schools by education office and school name, then retrieving meal information for specified dates. It handles common ambiguities gracefully, such as when multiple schools share the same name or when education office names could match several regions. Users receive clean, formatted meal information including breakfast, lunch, and dinner menus with nutritional details, rather than raw JSON data. The system automatically converts dates to Korean timezone (KST) and formats menu items for readability by replacing HTML breaks with proper line breaks.
This skill is designed for Korean-speaking users who need quick access to school meal information, including parents checking their children's lunch menus, students planning their meals, school administrators verifying published menus, and education researchers analyzing meal programs. The skill eliminates the complexity of directly interfacing with government APIs by requiring no API keys on the client side—all authentication is handled transparently by the proxy service. It supports all Korean education offices and schools registered in the NEIS system.
No. The skill uses k-skill-proxy which manages the NEIS API key (KEDU_INFO_KEY) on the server side. Users only need internet connectivity and can optionally set KSKILL_PROXY_BASE_URL if using a self-hosted proxy instance.
The skill will present all matching schools with their addresses and ask you to select the specific school you're interested in. Never assume or randomly pick when multiple matches exist.
Yes. You can specify any date in YYYYMMDD format or use natural language like "next Tuesday." If no date is provided, it defaults to today (Korean time). However, meals may not be available for holidays, weekends, or vacation periods.
If your input matches multiple education offices (e.g., "Gyeongsang" could mean Gyeongsangbuk-do or Gyeongsangnam-do), the skill will show candidate options and ask you to specify which one you meant.
Results include meal menus for breakfast, lunch, and dinner with dish names formatted for readability. Nutritional information such as calorie counts is also included when available from the NEIS system.
Quick Setup:
.claude/skills/Repository
nomadamas/k-skill