00. 들어가며 — 왜 K-Skill인가?
AI에게 "KTX 예매해줘", "우리 아파트 실거래가 뽑아줘"가 진짜로 되는 세상
2025년 하반기 Claude가 '스킬(Skill)' 기능을 공개하면서 AI 활용 패러다임이 완전히 바뀌었다. 이전까지 AI는 채팅만 하는 존재였지만, 스킬을 통해 이제는 실제로 외부 서비스를 조작하고 일을 대신 처리할 수 있는 '에이전트(Agent)'가 되었다. 문제는 Anthropic이 공개한 기본 스킬들이 대부분 미국 서비스 중심이라는 것. 한국인에게 진짜 필요한 건 SRT 예매, 실거래가 조회, 법령 검색, HWP 파일 처리인데 이런 건 해외 스킬에 없다.
바로 이 공백을 채우는 오픈소스 프로젝트가 K-Skill이다. 국내 개발자 커뮤니티 NomaDamas가 2025년 공개한 이후 빠르게 성장해, 현재 44개 스킬 · 8개 카테고리를 갖춘 한국 최대 규모의 Claude 스킬 컬렉션이 되었다. 2026년 4월 KREMA 'AI PPT 제작 올인원 클래스'에서 챗대리(박진주) 대표가 "한국인이 쓰기 좋은 스킬 모음"으로 공식 소개한 그 프로젝트다.
이 문서는 K-Skill을 "처음 듣는 사람도 바로 쓸 수 있게" 정리한 실전 매뉴얼이다. 각 스킬별로 "Claude에게 이렇게 말하면 됩니다" 예시가 포함되어 있다. 초보자는 예시대로 따라 하면 되고, 숙련자는 이걸 템플릿 삼아 자기 업무에 맞게 커스터마이즈하면 된다.
01. K-Skill이란?
K-Skill은 한국인이 일상에서 자주 쓰는 서비스들을 AI 에이전트(Claude Code · Codex · OpenCode 등)가 자연어 명령으로 조작할 수 있게 해주는 스킬 모음집이다.
K-Skill을 이루는 3가지 핵심 구성
| 구성요소 |
역할 |
| SKILL.md 파일 |
각 스킬이 무엇을 할 수 있는지, 어떻게 호출하는지 적혀 있는 지침서. AI가 이 파일을 읽고 작업 수행. |
| 실행 스크립트 |
실제로 서비스에 요청을 보내는 Python/Node.js 코드. SRT 예매 같은 건 내부에 korail2 라이브러리를 쓰는 식. |
| k-skill-proxy |
공공 API 키를 운영자가 대신 관리해주는 프록시 서버. 사용자가 개별 API 키 발급받지 않고도 쓸 수 있게 해주는 인프라. |
K-Skill의 가장 큰 장점 - 공공 API 키 발급 없이 바로 쓸 수 있는 스킬이 많다. 미세먼지·한강 수위·주유소 가격·주식 정보·부동산 실거래가 등이 대표적. 이건 NomaDamas 운영진이 k-skill-proxy.nomadamas.org에서 공공 API 키를 대신 관리해주기 때문. 일반 개인이 공공데이터포털에서 키 받으려면 신청·승인에 최소 2~3일 걸리던 것을 한 줄 설치로 끝낼 수 있다.
02. 주목해야 하는 이유
- 한국 특화 = 해외 AI가 못 하는 일 — HWP 파일 처리, 공공데이터포털 API 연동, 조선왕조실록 검색 등 글로벌 AI 도구로는 커버되지 않는 영역이 통째로 해결된다.
- 공공 API를 키 없이 사용 — 미세먼지·한강 수위·부동산 실거래가처럼 원래는
data.go.kr에서 신청·승인 과정이 필요한 데이터를 즉시 쓸 수 있다.
- 모든 주요 에이전트 호환 — Claude Code, ChatGPT Codex, Gemini CLI, OpenCode, Cursor 전부 지원. 한 번 설치하면 에이전트 바꿔도 그대로 쓴다.
- MIT 라이선스 — 업무에 써도 되고, 회사 내부 시스템에 통합해도 된다. 라이선스 비용 0원.
- 활발한 개발 — 2025년 말 출시 후 빠르게 확장 중. 사용하지 않는 스킬은
deprecated로 명확히 표시하고, 새 스킬이 꾸준히 추가된다.
▶ 부동산 마케팅 기획 실무자에게
K-Skill에는
/real-estate-search라는
국토교통부 실거래가 조회 스킬이 포함되어 있다. 원래 이 데이터는 공공데이터포털에서 개발자 키 받고 REST API 호출해야 하는데, K-Skill 설치 후에는 Claude에게 "서울 강남구 대치동 아파트 최근 실거래가 알려줘"라고만 하면 된다.
03. 설치 방법 — 한 줄로 끝내기
사전 준비 체크리스트
- 에이전트 하나 — Claude Code / ChatGPT Codex / OpenCode 중 택1 (Claude Code가 가장 무난)
- Node.js + npm 설치 — nodejs.org에서 LTS 버전 다운로드
- Python 3 — SRT/KTX 예매 스킬 등 일부용
- macOS Homebrew — (선택) 카카오톡 CLI 등 macOS 전용 스킬용
STEP 1 · 한 줄로 전체 설치
npx --yes skills add NomaDamas/k-skill --all -g
이 명령어가 ~/.claude/skills/ 또는 ~/.agents/skills/ 폴더에 44개 스킬을 모두 설치한다. 개별 설치 없이 통째로.
짐의 도구들을 그대의 손에 쥐어드리는 법을 일러주리라. 한 줄의 주문(呪文)으로 모든 도구가 그대의 컴퓨터에 깃들 것이오. — K-Skill 공식 안내문 중
STEP 2 · 자격증명 자동 설정
설치 후 에이전트(Claude Code 등)에서 다음 메시지를 그대로 붙여넣으면 된다.
이 레포의 설치 문서를 읽고 k-skill 전체 스킬을 먼저 설치해줘. 설치가 끝나면 k-skill-setup 스킬을 사용해서 credential 확보와 환경변수 확인까지 이어서 진행해줘. 끝나면 설치된 스킬과 다음 단계만 짧게 정리해.
STEP 3 · 설치 확인
npx --yes skills ls -g
설치된 스킬 44개 목록이 쭉 출력되면 성공.
STEP 4 · 첫 사용 테스트
설치가 잘 됐는지 가장 간단한 스킬로 확인해보자. Claude Code 채팅창에 이렇게 입력.
첫 스킬 테스트 — 로또 당첨 확인
최신 회차 로또 당첨번호 알려줘
로또 최신 회차는 [번호]회입니다. 당첨번호는 [수치] + 보너스번호 [수치]이며, 1등 당첨금은 [금액]입니다...
완전 초보자라면? 터미널 대신 Claude 데스크톱/웹 버전에서 쓰는 스킬을 먼저 시도해보는 게 낫다. Claude 설정 → Customize → 스킬 → "스킬 만들기" → 업로드 방식으로 .skill 파일을 개별 설치하는 방법도 있다. 단, 이 경우 GitHub에서 원하는 스킬만 ZIP 다운로드해 하나씩 올려야 한다. AI PPT 제작 올인원 클래스 강의에서 실습한 것과 같은 방식.
04. 스킬 44종 카테고리별 전체 정리 (자연어 명령 포함)
각 스킬마다 "Claude에게 이렇게 말하면 이렇게 실행된다"는 자연어 명령 예시를 함께 정리했다. 이 예시 그대로 따라 쳐도 되고, 자기 상황에 맞게 고쳐 써도 된다.
/ktx-booking
KTX 예매
좌석 검색, 예매/취소, 열차 변경, 예약 내역 조회. Python korail2 패키지 필요.
"내일 오전 9시쯤 서울에서 부산 가는 KTX 특실 예매해줘"
계정 로그인 필요
/srt-booking
SRT 예매
수서발 고속열차 예매. 매진된 열차라도 재시도 계획을 세워 자동 예매 시도.
"이번 금요일 저녁 수서→부산 SRT 예매해줘. 매진이면 재시도해"
계정 로그인 필요
/cheap-gas-nearby
근처 가장 싼 주유소
오피넷(Opinet) 공식 자료 기반. 유종별 가격 비교.
"강남역 근처 가장 싼 휘발유 주유소 찾아줘"
바로 사용 가능
/seoul-subway-arrival
서울 지하철 도착정보
실시간 도착 정보, 호선별 검색.
"삼성역에서 지금 열차 몇 분 후에 도착해?"
바로 사용 가능
/subway-lost-property
지하철 분실물 조회
LOST112 + 서울교통공사 기록 조회.
"어제 2호선에서 가방 잃어버렸어. 찾아줘"
바로 사용 가능
/delivery-tracking
택배 배송조회
CJ대한통운·우체국 통합 조회.
"운송장 번호 123456789 지금 어디 있어?"
바로 사용 가능
/hipass-receipt
하이패스 영수증 발급
법인 차량 통행료 영수증 자동 발급. Chrome 세션 필요.
"지난달 하이패스 통행료 영수증 다 뽑아줘"
브라우저 로그인
/public-restroom-nearby
근처 공중화장실
전국 공중화장실 공식 자료. 위치 기반 검색 + 개방 여부.
"여기서 가장 가까운 공중화장실 어디야?"
바로 사용 가능
/kakao-bar-nearby
근처 술집 조회
카카오 지도 기반. 영업 중 필터 + 메뉴·좌석 정보.
"강남역 10시 넘어도 하는 술집 4명 예약 가능한 곳"
바로 사용 가능
/household-waste-info
생활쓰레기 배출정보
지역별 배출 요일·장소·품목 분리수거 정보.
"서초구에서 음식물 쓰레기 언제 배출해?"
바로 사용 가능
/hola-poke-yeoksam
올라포케 역삼점
특정 매장 메뉴·이벤트 조회 예시 (단일 매장).
"올라포케 역삼점 오늘 점심 메뉴 뭐 있어?"
바로 사용 가능
/kakaotalk-mac
카카오톡 Mac CLI
채팅 내역 조회·검색·답장 전송(확인 후).
"지난 일주일간 KREMA 단톡방에서 '이사회' 언급된 메시지 찾아줘"
macOS 전용
/k-schoollunch-menu
학교 급식 식단
NEIS 기록 기반. 학교·날짜별 식단.
"OO초등학교 이번 주 급식 식단 알려줘"
바로 사용 가능
/blue-ribbon-nearby
블루리본 맛집 (Deprecated)
블루리본 측 자동화 차단으로 더 이상 동작하지 않음.
— 사용 불가 —
사용 불가
/blue-ribbon-nearby처럼 외부 서비스 정책 변경으로 동작 중단된 스킬이 일부 있다. K-Skill README에 명확히 deprecated 표시가 되어 있으니 설치 후 k-skill-setup으로 확인할 것. 이건 오픈소스의 한계가 아니라, 서비스 제공사(블루리본)가 자동화 접근을 nginx 단에서 403으로 막아서 브라우저·curl·Playwright 어떤 방법으로도 우회 불가.
/daiso-product-search
다이소 상품 조회
매장별 재고 확인.
"강남역 다이소에 A4용지 500매 있어?"
바로 사용 가능
/market-kurly-search
마켓컬리 상품 조회
로그인 없이 상품 검색 + 가격·할인·품절.
"마켓컬리에서 유기농 계란 최저가 찾아줘"
바로 사용 가능
/bunjang-search
번개장터 검색
중고 상품 검색·상세 조회·찜·채팅·대량 수집.
"번개장터에서 맥북 M3 Pro 14인치 50만원 이하 있어?"
바로 사용 가능
/olive-young-search
올리브영 검색
매장별 상품 재고 확인.
"우리 동네 올리브영에 아누아 토너 재고 있는지 확인해줘"
바로 사용 가능
/coupang-product-search
쿠팡 상품 검색
로켓배송 필터·가격대 검색·골드박스 특가.
"쿠팡 로켓배송으로 A4용지 2500매 10만원 이하 찾아줘"
바로 사용 가능
/fine-dust-location
미세먼지 조회
에어코리아 공식. API 키 불필요.
"오늘 서울 강남구 미세먼지 어때? 등급도 알려줘"
바로 사용 가능
/mfds-food-safety
식품 안전 체크
식약처 공식. 증상·섭취 상황 기반 인터뷰.
"어제 먹은 횟집 굴에서 배탈났어. 식품 안전 체크해줘"
바로 사용 가능
/zipcode-search
우편번호 검색
우체국 공식 통합 검색. 영문 주소 변환.
"서울 영등포구 여의도동 KREMA 주소 우편번호랑 영문주소 알려줘"
바로 사용 가능
/mfds-drug-safety
의약품 안전 체크
식약처 공공 자료 기반.
"타이레놀이랑 소주 같이 먹어도 돼?"
바로 사용 가능
/korean-scholarship-search
장학금 검색
한국장학재단·대학·기업 장학금 공고.
"서울 사립대 건축학과 4학년 성적우수 장학금 찾아줘"
바로 사용 가능
/han-river-water-level
한강 수위 정보
관측소별 실시간 수위·유량.
"한강대교 지금 수위 어때? 홍수 주의보 발령 상태야?"
바로 사용 가능
/korea-weather
한국 날씨 조회
기상청 단기예보 + 지역별 요약.
"이번 주말 강원도 속초 날씨 어때? 비 올까?"
바로 사용 가능
/korean-law-search
한국 법령 검색
한국 법령 MCP 기반. 법제처 API 키(LAW_OC) 필요.
"주택법 제15조 내용 알려줘"
강사 추천
/kbl-results
KBL 경기 결과
한국 프로농구 경기 결과·순위 조회.
"어제 KGC인삼공사 경기 결과 알려줘"
바로 사용 가능
/kbo-results
KBO 경기 결과
야구 일정·점수.
"오늘 LG 트윈스 경기 몇시에 하고 상대 어디야?"
바로 사용 가능
/kleague-results
K리그 경기 결과
K리그 경기 결과·리그 순위·팀별 조회.
"K리그1 현재 순위 알려줘"
바로 사용 가능
/lck-analytics
LCK 경기 분석
경기 결과·순위·밴픽 분석·패치 메타·팀 파워 레이팅.
"어제 T1 vs Gen.G 경기 밴픽 분석해줘"
바로 사용 가능
/hwp
HWP 문서 처리
한글(HWP·HWPX) 파싱·양식 작성·마크다운 변환.
"이 hwp 파일 내용 마크다운으로 변환해줘"
공공업무 필수
/geeknews-search
긱뉴스 조회
긱뉴스(news.hada.io) 최신 게시물·키워드 검색.
"긱뉴스에서 이번 주 AI 관련 상위 5개 글 요약"
바로 사용 가능
/naver-blog-research
네이버 블로그 리서치
API 키 없이 블로그 검색·본문 읽기·이미지 다운로드.
"'강남구 재건축' 키워드 최근 블로그 10개 본문 수집"
바로 사용 가능
/joseon-sillok-search
조선왕조실록 검색
키워드·왕·연도별 검색.
"세종실록에서 '토지' 언급된 기록 찾아줘"
바로 사용 가능
/korean-patent-search
한국 특허 정보
KIPRIS Plus 공식. API 키 필요.
"'스마트홈 월패드' 관련 최근 3년 특허 찾아줘"
API 키 필요
/korean-character-count
한국어 글자 수 세기
자소·줄 수·바이트 정확히 계산.
"이 원고 공백 포함 글자수랑 바이트 수 알려줘"
바로 사용 가능
/korean-spell-check
한국어 맞춤법 검사
긴 글도 자동 분할 후 꼼꼼히 검사.
"이 보도자료 맞춤법 검사하고 교정 제안해줘"
바로 사용 가능
/used-car-price-search
중고차 가격 조회
SK렌터카 다이렉트 등 렌터카 업체 비교 + 인수가.
"2021년식 쏘렌토 하이브리드 중고가 시세 알려줘"
바로 사용 가능
/toss-securities
토스증권 조회
읽기 전용. 계좌·포트폴리오·시세·주문 내역.
"내 토스증권 포트폴리오 이번 달 수익률 얼마야?"
로그인 필요
/real-estate-search
한국 부동산 실거래가
국토교통부 공공자료. 아파트·오피스텔·빌라·단독주택. API 키 불필요.
"서울 강남구 대치동 은마아파트 최근 3개월 실거래가 알려줘"
부동산 실무 Pick
/korean-stock-search
한국 주식 정보
KRX 공식. 종목 검색·일별 거래 현황. API 키 불필요.
"GS건설 최근 1개월 주가 흐름이랑 거래량 알려줘"
바로 사용 가능
05. 부동산·마케팅 기획 실무자 Pick
실무진이 가장 자주 쓰게 될 스킬을 골랐다. 분양·시장조사·회원 대응 업무 흐름에 맞춰 조합해서 쓰면 AI 에이전트 한 명이 리서치 인턴 한 명 분량 일을 한다.
⭐ 1순위 · 필수
/real-estate-search — 한국 부동산 실거래가 조회
국토교통부 공공데이터 기반. 아파트·오피스텔·빌라·단독주택의 실거래가와 전월세 정보를 API 키 없이 바로 조회. 분양가 산정 전 주변 실거래 분석, 회원사 경쟁 현장 조사, 협회 리포트 작성 시 수 시간짜리 수기 엑셀 작업을 대체.
⭐ 2순위 · 협회 업무
/korean-law-search — 한국 법령 검색
법제처 법령 MCP 기반. 부동산 관련 법령(주택법·건축법·공동주택관리법 등) 조문을 자연어로 질의 가능. "지난주 개정된 주택법 몇 조에서 뭐가 바뀌었어?" 같은 질문이 통한다. 법제처 API 키(LAW_OC) 발급 필요 — open.law.go.kr에서 간단 신청.
⭐ 3순위 · 리서치
/naver-blog-research — 네이버 블로그 리서치
현장 분위기·임장기·실거주 후기 크롤링. 공식 통계로 안 잡히는 정성적 데이터 수집에 최고. API 키 없이 검색·본문 읽기·이미지 다운로드. "강남구 대치동 디에이치 대치 에델루이 실거주 후기 최근 10건 요약"이 한 줄로 가능.
⭐ 4순위 · 일상 업무
/zipcode-search + /delivery-tracking
회원사 공문 발송 주소 자동 검증 + 발송 후 배송 조회. 수백 건의 회원사 주소를 일괄 처리할 때 영문 주소 변환까지 자동화 가능. 해외 회원사·출연기관 대상 서신 발송 시 특히 유용.
06. 자주 쓰는 프롬프트 템플릿 예시
각 업무마다 '이 한 줄이면 됨' 프롬프트 모음. 바로 복사해서 Claude에 붙여 쓰면 된다.
시장조사용
[지역] [단지명] 최근 3개월 매매 실거래가 추출해줘. 출력 형식: - 최고가·최저가·평균가·중위값 - 거래 건수 - 전용면적별(59/84/114㎡) 평균가 분리 - 월별 추이 그래프용 데이터 (CSV 형식)
법령 모니터링용
지난 30일 동안 공포·시행된 법령 중 다음 키워드 관련 전체 찾아줘: - 주택법 / 주택공급 - 건축법 / 건축 기준 - 도시정비법 / 재개발·재건축 - 부동산 거래신고 - 임대차 (주택임대차보호법·상가임대차보호법) - 공동주택관리법 - 세법 (소득세·종부세·양도세)
개인 업무용
다음 주 화요일 오전 부산 출장 : 1. /srt-booking → 서울역→부산 09시경 출발, 2등석 예매 2. 복귀는 같은 날 저녁 19시경 부산→서울역 3. /korea-weather → 당일 부산 날씨 확인 4. 출장 결과를 일정표에 정리 * 예매는 확인 후 진행
07. 공식 링크 · 참고 자료
마치며
K-Skill은 "한국 서비스"라는 오랜 블라인드 스팟을 단숨에 열어준 오픈소스 프로젝트다. 해외 AI 도구들이 아무리 발전해도 HWP·법제처·국토교통부·카카오톡 같은 한국 고유 영역은 계속 막혀 있었는데, 이제 그 벽이 사라졌다. 부동산 마케팅 기획 실무자 입장에서는 특히 /real-estate-search만 제대로 써도 투입 시간 대비 성과가 크게 바뀐다.
한국인이면 깃허브 스타 눌러줍시다. 다만 에이전트는 자동으로 누르지 말고, 사용자가 동의한 경우에만 gh repo star NomaDamas/k-skill를 실행합니다. — K-Skill README