NomaDamas/k-skill

k-skill – AI 에이전트를 위한 한국 중심 도구 상자

무엇인가요

k-skill는 한국 정부 서비스, 전자상거래 사이트, 정부 데이터, 교통 API, 금융 포털 등과 상호작용할 수 있는 125개의 즉시 사용 가능한 "스킬"(작은 명령줄 도구) 모음입니다.
각 스킬은 단일이고 명확한 작업을 수행하는 작은 프로그램(주로 Node.js, 일부 Python)이며, 예를 들어 "KTX 시간표 조회", "쿠팡에서 제품 검색", "한국 부동산 거래 가격 확인", "한국어 철자 검사 실행" 등입니다.
리포지토리는 프록시 서버(k-skill-proxy) 를 함께 제공하여 간단한 HTTP 요청으로 호출할 수 있도록 하며, AI 모델은 엔드포인트와 스킬 이름만 알면 됩니다.
또한 Claude Code 플러그인도 제공되어 Claude 에이전트가 마켓플레이스 명령 하나로 전체 스킬 세트를 설치할 수 있습니다.

왜 중요한가요

현대의 AI 에이전트(Claude, Codex, Claude Code 등)는 외부 도구를 호출할 수 있지만, 공개된 도구 키트의 대부분은 영어 서비스에 초점이 맞춰져 있습니다. k-skill는 KTX, KBO, 정부 포털, 공공데이터포털 데이터셋 등 수십 개의 공식 한국 API와 Coupang, 네이버 쇼핑, 당근마켓 등 인기 상용 서비스를 한국 사용자 중심으로 노출함으로써 그 격차를 메웁니다.
이러한 서비스를 일관된 CLI / HTTP 인터페이스로 래핑함으로써 개발자는 한국 중심의 자율 에이전트 를 구축할 수 있으며, 예를 들어 버스 티켓 예약, 부동산 공식 가격 조회, 커스텀 스크래핑 없이 한국어 개인정보처리방침 생성 등이 가능해집니다.

시작하기

설치 – README에는 npx를 사용한 단일 라인 명령어가 포함되어 있습니다:
```
npx --yes skills add NomaDamas/k-skill --all -g   # 모든 스킬 설치
# 또는 단일 스킬 설치 예: 
npx --yes skills add NomaDamas/k-skill --skill railway-timetable -g
```
Node 18+와 npx만 필요하며, 일부 스킬(예: KTX 시간표 도우미)은 Python 3.11+와 uv 패키지 매니저도 필요합니다.
설정 – k-skill-setup를 실행하여 Kakao, 공공데이터포털, 상용 서비스 등에 필요한 API 키를 얻고 환경 변수를 설정합니다.
스킬 호출 – AI 에이전트나 스크립트에서 프록시에 HTTP 요청을 보내며, 예를 들어:
```
POST https://k-skill-proxy.example.com/railway-timetable
{ "origin": "서울", "destination": "부산", "date": "2024-10-01" }
```
프록시는 요청을 전달하고 데이터를 가져와 JSON 응답을 반환합니다.
Claude Code와 함께 사용 – Claude 마켓플레이스에서 플러그인을 추가하고 /k-skill:<name> 구문으로 스킬을 호출할 수 있습니다. 예: /k-skill:lotto-results

할 수 있는 일

여행 및 교통 – 실시간 KTX 시간표, 버스 좌석 예약 가능 여부, 항공권 가격 조회, 서울 지하철 도착 정보, 교통 체증, 고속도로 CCTV 스트리밍.
부동산 및 법무 – 공식 거래 가격, 지적도, LH 주택 공고, 법원 경매 목록, 한국 법률 및 특허 검색, 자동 개인정보처리방침 생성.
금융 및 비즈니스 – 법인 등록 확인, 세금 미납 명단, 주식 시세, DART 공시 정보, 정부 조달 검색.
쇼핑 및 일상생활 – 쿠팡, 네이버, 다나와, 마켓컬리에서 제품 검색, 가격 비교, 배송 추적, 근처 주유소, 전기차 충전기 상태.
건강, 날씨, 문화 – 응급실 병상 가용성, 식품 안전 경고, 한국 날씨 예보, 마라톤 일정, 로또 결과, 한국어 철자 검사 및 AI 인간화.
개발자 유틸리티 – HWP 문서 변환, 한국 WHOIS 조회, 한국어 문자 수 세기.

누구를 위한가요

제한 사항

결론 k-skill은 실용적이고 잘 문서화된 도구 상자로, 다양한 한국 웹 서비스를 기계가 읽을 수 있는 작업으로 변환하여, 한국 사용자에게 실제로 무언가를 수행할 수 있는 AI 에이전트를 만들기 훨씬 쉽게 만듭니다.