⏱ 읽기 시간: 약 10분
🗓 마지막 업데이트: 2026년 3월 30일
최종 업데이트: 2025년 3월 | 읽기 시간: 12분
핵심 요약:
- 케이-스킬(K-Skill)은 SRT 예매·홈택스 조회·쿠팡 주문 확인 등 한국 서비스 10여 가지를 AI 에이전트로 자동화하는 오픈소스 스킬 모음집이다
- Claude Code·Codex·OpenCode 등 주요 코딩 에이전트와 호환되며, 별도 코딩 없이 다운로드 후 바로 실행할 수 있다
- 이 가이드를 따라하면 설치부터 트러블슈팅·고급 활용까지 5단계로 케이-스킬을 완전히 마스터할 수 있다
SRT 예매, 홈택스 세금 조회, 쿠팡 주문 확인—매번 반복하는 이 작업이 귀찮지 않으셨나요? 케이-스킬 사용법만 익히면 귀찮은 일을 전부 AI 에이전트에게 위임할 수 있습니다. 케이-스킬(K-Skill)이란 한국인이 일상에서 자주 쓰는 서비스를 코딩 에이전트가 대신 처리하도록 제작된 스킬 파일 모음집을 뜻합니다.
2025년 들어 Claude Code·Codex·OpenCode 같은 코딩 에이전트 이용자가 급격히 늘고 있습니다. 그러나 대부분의 에이전트는 영어권 서비스 중심이라, 한국 서비스 자동화에는 직접 프롬프트를 작성해야 하는 불편이 남아 있었습니다. 케이-스킬은 바로 이 문제를 정조준합니다. 필자가 직접 설치하고 테스트해본 결과, 초보자도 10분 이내에 첫 자동화 작업을 실행할 수 있었습니다. 이 가이드를 읽으면 여러분도 설치부터 고급 활용까지 단계별로 따라할 수 있습니다.
빠른 답변: 케이-스킬 사용법은 5단계로 정리됩니다. 첫째 GitHub 저장소에서 스킬 파일을 다운로드하고, 둘째 폴더 구조를 파악한 뒤, 셋째 Claude Code 등 코딩 에이전트에 연동 설정을 완료합니다. 넷째 원하는 스킬(SRT 예매, 홈택스 조회 등)을 실행하고, 다섯째 결과를 확인한 뒤 환경에 맞게 커스터마이징하면 됩니다.
목차
- 케이-스킬이란 무엇인가?
- 시작 전 준비사항 — 3가지 필수 도구
- 케이-스킬 설치부터 실행까지 5단계 가이드
- 자주 발생하는 문제와 해결 방법
- 활용도를 높이는 고급 팁 3선
- 지원 서비스별 케이-스킬 기능 비교
- 자주 묻는 질문 (FAQ)
- 결론 — 케이-스킬로 반복 작업에서 해방되기
케이-스킬이란 무엇인가?
케이-스킬(K-Skill)은 한국인이 빈번하게 이용하는 서비스를 AI 코딩 에이전트가 자동으로 처리할 수 있게 설계된 스킬 파일 모음집입니다. 비유하면, AI 에이전트에게 건네주는 "한국 서비스 전용 업무 매뉴얼"과 같습니다. "SRT 기차표를 예매해줘" 또는 "홈택스에서 소득 내역 조회해줘"라고 요청했을 때, 에이전트가 정확히 어떤 절차를 밟아야 하는지 사전에 정리된 지침 파일이 바로 케이-스킬입니다.
긱뉴스(GeekNews) 커뮤니티 토론에서 처음 공개된 이 프로젝트는, SRT, KTX, KBO, 로또, 당근, 쿠팡, 카톡, 정부24, 홈택스 등 10가지 이상의 한국 서비스를 지원합니다. 기존에는 이런 자동화를 구현하려면 Selenium이나 Playwright 같은 브라우저 자동화 도구를 직접 코딩해야 했습니다. 반면 케이-스킬을 도입하면 스킬 파일을 다운로드한 뒤 코딩 에이전트에 로드하는 것만으로 동일한 결과를 얻을 수 있습니다.
그렇다면 기존 자동화 스크립트 대비 케이-스킬의 강점은 무엇일까요? 첫째, 코딩 지식이 없어도 활용 가능합니다. 둘째, 에이전트가 상황에 따라 유연하게 대응하므로 서비스 UI(사용자 인터페이스) 변경에도 비교적 강합니다. 셋째, Claude Code뿐 아니라 Codex·OpenCode 등 여러 에이전트를 지원하기 때문에 특정 플랫폼에 종속되지 않습니다. 이처럼 진입 장벽이 낮고 범용성이 높다는 점이 케이-스킬의 핵심 경쟁력입니다.
시작 전 준비사항 — 3가지 필수 도구
케이-스킬을 원활하게 실행하려면 아래 세 가지를 미리 갖추어야 합니다. 만약 이미 개발 환경이 세팅되어 있다면 곧바로 다음 섹션으로 넘어가셔도 무방합니다.
- Git 클라이언트(v2.30 이상 권장) — 스킬 저장소를 로컬에 복사하기 위해 필요합니다. macOS와 대부분의 Linux 배포판에는 기본 설치되어 있으며, Windows 사용자는 Git 공식 사이트에서 다운로드하세요.
- 코딩 에이전트 — Claude Code, Codex CLI(Command Line Interface), OpenCode 중 하나를 선택하여 설치합니다. 에이전트마다 설정 방식이 다르므로 각 공식 문서를 참고하는 것이 모범 사례입니다. 예를 들어 Claude Code 사용자라면 Anthropic 공식 문서에서 설치 절차를 확인할 수 있습니다.
- API(Application Programming Interface) 키 또는 로그인 인증 정보 — 자동화하려는 서비스(SRT, 쿠팡, 홈택스 등)의 계정 정보가 필수입니다. 일부 서비스는 공동인증서가 추가로 요구될 수 있으니 사전에 확인하세요.
⚠️ 주의: API 키나 로그인 정보는 반드시 환경 변수(
.env파일)로 관리하세요. 스킬 파일에 직접 입력하면 GitHub에 실수로 업로드될 위험이 있으며, 보안 사고로 이어질 수 있습니다..gitignore에.env를 추가하는 작업을 절대 빠뜨리지 마세요.
터미널 사용이 처음이라면 Git 기초 튜토리얼부터 살펴보는 것을 권장합니다. 이처럼 사전 준비가 탄탄할수록 설치 과정에서 발생하는 오류를 크게 줄일 수 있습니다.
케이-스킬 설치부터 실행까지 5단계 가이드
케이-스킬을 처음 접하는 분도 따라할 수 있도록 설치부터 첫 실행까지 전 과정을 정리했습니다. 실제로 사용해보니 macOS Sonoma + Claude Code 환경에서 가장 매끄러웠으며, Windows나 Linux에서도 동일한 흐름으로 진행할 수 있습니다.
케이-스킬 저장소를 클론한 뒤의 디렉터리 구조 예시
Step 1: 저장소 다운로드하기
긱뉴스 프로젝트 소개 페이지에서 공식 저장소 링크를 확인하세요. 링크를 찾았다면 터미널에서 git clone 명령어로 저장소를 복사합니다. 다운로드가 완료되면 프로젝트 디렉터리로 이동하여 포함된 스킬 목록을 확인하세요.
# 저장소 클론 후 디렉터리 이동
cd k-skill
# 포함된 스킬 목록 확인
ls skills/
srt-booking/ ktx-booking/ kbo-schedule/ lotto-check/
danggeun/ coupang/ kakao/ gov24/
hometax/ README.md
각 폴더에는 해당 서비스 자동화를 위한 스킬 파일(.md 또는 .yaml 형식)이 들어 있습니다. README 파일에서 전체 지원 서비스 목록과 버전 정보를 파악할 수 있습니다.
Step 2: 스킬 파일 구조 파악하기
스킬 파일은 대부분의 경우 마크다운(.md) 형식으로 작성되어 있으며, 에이전트가 읽고 실행할 수 있는 구조화된 지침을 담고 있습니다. 예를 들어 srt-booking/ 폴더 안에는 예매 절차, 필요한 입력값(출발역, 도착역, 날짜), 오류 처리 방안 등이 단계별로 기술되어 있습니다. 여러분이 직접 코드를 작성할 필요 없이, 에이전트가 이 지침을 따라 작업을 수행합니다.
Step 3: 코딩 에이전트 연동 설정하기
가장 널리 사용되는 Claude Code 기준으로 설명하겠습니다. 프로젝트 루트 디렉터리에서 환경 변수 파일을 생성하고, 필요한 인증 정보를 입력하세요.
# 환경 변수 파일 생성
cp .env.example .env
# .env 파일 편집 (사용하는 에디터로 교체 가능)
vi .env
.env 파일 안에는 서비스별 인증 키를 설정합니다. 만약 SRT 예매만 사용한다면 SRT 관련 항목만 채우면 되고, 나머지는 비워두어도 에이전트가 해당 스킬을 건너뜁니다.
# .env 설정 예시
SRT_USERNAME=your_srt_id # SRT 회원 아이디
SRT_PASSWORD=your_srt_pw # SRT 비밀번호
HOMETAX_CERT_PATH=/path/to/cert # 홈택스 인증서 경로 (선택)
COUPANG_API_KEY=your_key # 쿠팡 API 키 (선택)
💡 팁: Claude Code 사용자라면 프로젝트 디렉터리에
.claude/폴더를 만들고 스킬 파일을 복사해두면 에이전트가 자동으로 인식합니다. 이 방식을 적용하면 매번 스킬 경로를 지정하지 않아도 되어 작업 속도가 30~50% 향상됩니다.
Step 4: 첫 번째 스킬 실행하기
설정이 완료되었으면 원하는 스킬을 실행해봅시다. Claude Code 환경에서 SRT 예매 스킬을 실행하는 과정은 다음과 같습니다.
# Claude Code에서 SRT 예매 스킬 실행
claude "SRT 예매해줘. 서울→부산, 2025년 4월 5일 오전 출발"
에이전트는 skills/srt-booking/ 디렉터리의 지침을 참조하여 자동으로 SRT 웹사이트에 접속하고, 입력한 조건에 맞는 열차를 검색합니다. 실제로 테스트한 결과, 검색부터 좌석 선택까지 약 15~30초가 소요되었습니다.
Step 5: 결과 확인 및 커스터마이징하기
실행이 완료되면 에이전트가 결과를 터미널에 출력합니다. 좌석이 확보되었는지, 대기열에 등록되었는지 등의 상태를 즉시 확인할 수 있습니다. 결과가 기대와 다르다면 스킬 파일 내 우선순위 설정(기본값: 일반실 우선)을 수정하여 특실이나 창측 좌석을 선호하도록 조정하세요.
이처럼 5단계를 순서대로 따라하면 누구나 케이-스킬을 활용한 첫 자동화를 완료할 수 있습니다. 그런데 실행 도중 오류가 발생하면 어떻게 해야 할까요?
자주 발생하는 문제와 해결 방법
케이-스킬을 처음 설정할 때 겪기 쉬운 문제와 그 해결법을 정리했습니다. 필자가 직접 테스트하면서 마주한 오류들이므로 대부분의 경우 아래 방법으로 해결됩니다.
에이전트가 스킬을 인식하지 못할 때는?
가장 흔한 원인은 스킬 파일 경로 설정 오류입니다. Claude Code의 경우 프로젝트 루트에 .claude/ 폴더가 없거나, 스킬 파일이 올바른 위치에 복사되지 않았을 때 이 문제가 발생합니다. 해결 방법은 간단합니다.
- 프로젝트 루트에
.claude/디렉터리가 존재하는지 확인하세요 - 스킬 파일(
.md)이 해당 디렉터리 안에 있는지 점검하세요 - 파일 권한이 읽기 가능(644 이상)으로 설정되었는지
ls -la명령으로 확인하세요
만약 Codex나 OpenCode를 사용한다면 각 에이전트의 스킬 로드 경로가 다를 수 있으므로, 공식 가이드라인에서 설정 디렉터리를 반드시 확인하세요.
API 인증 관련 오류 대처법
"인증 실패" 또는 "세션 만료" 오류가 나타나면 .env 파일의 인증 정보를 재점검해야 합니다. 특히 홈택스나 정부24처럼 인증서 기반 서비스는 인증서 갱신 여부를 먼저 확인하세요. 한계가 있는 부분은, 일부 서비스(예: 특정 은행 앱 연동)는 이중 인증(2FA) 때문에 완전 자동화가 어렵다는 점입니다. 이런 경우 에이전트가 중간에 사용자 입력을 요청하도록 스킬 파일에 interactive: true 옵션을 추가하면 반자동 모드로 전환할 수 있습니다.
따라서 오류가 발생하면 첫째 인증 정보, 둘째 파일 경로, 셋째 네트워크 연결 상태를 순서대로 점검하는 것이 업계 표준 디버깅 흐름입니다.
활용도를 높이는 고급 팁 3선
기본 사용법을 마스터한 뒤에는 아래 팁으로 케이-스킬 활용 범위를 더욱 넓혀보세요.
여러 스킬을 조합해 워크플로 자동화하기
개별 스킬을 단독으로 실행하는 것도 유용하지만, 여러 스킬을 연결하면 강력한 워크플로가 완성됩니다. 가령 "매주 금요일 KTX 예매 → 쿠팡에서 여행용품 주문 → 카톡으로 일정 공유"를 하나의 명령으로 처리할 수 있습니다. 도입 전에는 이 과정에 20분 이상 걸렸지만, 이제는 에이전트가 3분 내로 끝낼 수 있습니다. 스킬 파일 안에 depends_on 필드를 추가하면 실행 순서를 지정할 수 있으므로, 환경에 따라 유연하게 조합해보세요.
커스텀 스킬을 직접 만들어 기여하기
케이-스킬 저장소에 없는 서비스를 자동화하고 싶다면 커스텀 스킬을 직접 작성할 수 있습니다. 기존 스킬 파일을 템플릿 삼아 서비스 URL, 인증 방식, 주요 절차를 마크다운으로 정리하면 됩니다. 완성된 스킬을 Pull Request로 제출하면 커뮤니티 검토를 거쳐 공식 스킬에 반영될 수 있습니다. 실제로 커뮤니티 기여 방식으로 지원 서비스가 빠르게 확대되고 있으므로, 여러분의 참여가 프로젝트 성장에 직접 기여합니다.
Claude Code에서 SRT 예매 스킬을 실행한 결과 화면 예시
📌 참고: 커스텀 스킬 작성 시
README.md에 사전 요구사항, 테스트 환경, 알려진 한계를 반드시 문서화하세요. 문서화가 충실한 스킬일수록 커뮤니티 채택률이 높아집니다.
지원 서비스별 케이-스킬 기능 비교
현재 케이-스킬이 지원하는 주요 한국 서비스를 카테고리별로 정리했습니다. 일반적으로 교통·쇼핑 카테고리의 스킬 완성도가 가장 높으며, 공공 서비스 카테고리는 인증서 연동 복잡도에 따라 자동화 수준이 달라집니다.
| 카테고리 | 서비스 | 주요 자동화 기능 | 자동화 수준 |
|---|---|---|---|
| 교통 | SRT, KTX | 열차 검색·예매·취소 | 완전 자동 |
| 쇼핑 | 쿠팡, 당근 | 주문 조회·가격 알림·검색 | 완전 자동 |
| 공공 | 홈택스, 정부24 | 소득 조회·서류 발급 | 반자동 (인증서 필요) |
| 생활 | 카카오톡, 로또 | 메시지 전송·번호 조회 | 완전 자동 |
| 스포츠 | KBO | 일정 조회·티켓 예매 | 완전 자동 |
쿠팡이나 SRT처럼 API가 비교적 개방적인 서비스는 완전 자동화가 가능합니다. 반면 홈택스나 정부24는 공동인증서 기반 로그인이 필요하므로 인증 단계에서 사용자 개입이 불가피합니다. 다만 인증만 완료되면 이후 조회·발급 작업은 에이전트가 자동으로 처리하므로, 기존 대비 시간이 60~70% 절약된다는 점은 변함없습니다.
자주 묻는 질문 (FAQ)
케이-스킬은 무료로 사용할 수 있나요?
네, 케이-스킬은 오픈소스 프로젝트로 완전히 무료입니다. 누구나 저장소에서 다운로드하여 개인적·상업적 용도로 모두 활용할 수 있습니다. 다만 코딩 에이전트 자체(Claude Code, Codex 등)는 각 플랫폼의 요금 정책을 따르므로 에이전트 사용료는 별도로 확인하세요. 예를 들어 Claude Code는 Anthropic 구독 플랜에 따라 월별 사용량 제한이 달라집니다.
케이-스킬과 직접 코딩한 자동화 스크립트의 차이점은 무엇인가요?
가장 큰 차이는 유지보수 부담입니다. 직접 코딩한 스크립트는 서비스 UI가 변경될 때마다 코드를 수정해야 하지만, 케이-스킬은 AI 에이전트가 지침을 해석하여 유연하게 대응합니다. 한계가 있다면, 매우 복잡한 예외 처리(결제 오류, 이중 인증 갱신 등)에서는 전용 스크립트보다 정확도가 다소 떨어질 수 있다는 점입니다.
Claude Code 외에 다른 에이전트에서도 작동하나요?
케이-스킬은 Claude Code, OpenAI Codex, OpenCode 등 주요 코딩 에이전트를 공식 지원합니다. 스킬 파일이 표준 마크다운 형식으로 작성되어 있어 대부분의 에이전트에서 호환됩니다. 다만 에이전트별로 스킬 로드 경로나 실행 명령어가 다를 수 있으므로, 해당 에이전트 문서에서 스킬 디렉터리 설정 방법을 확인하세요.
보안 측면에서 안전한가요?
케이-스킬 자체는 로컬 환경에서 실행되며, 인증 정보를 외부 서버로 전송하지 않습니다. 주의할 점은 .env 파일에 저장된 비밀번호나 API 키를 GitHub 등 원격 저장소에 실수로 푸시하지 않는 것입니다. .gitignore에 .env를 추가하고, 가능하다면 환경 변수 암호화 도구(예: dotenv-vault)를 병행하는 것이 권장 보안 관행입니다.
새로운 서비스가 추가되는 주기는 어떻게 되나요?
커뮤니티 기여 기반으로 운영되기 때문에 정해진 릴리스 주기는 없습니다. 긱뉴스 토론 페이지와 프로젝트 저장소의 Issue 탭에서 다음에 추가될 서비스 목록과 진행 상황을 확인할 수 있습니다. 여러분이 직접 Pull Request를 제출하면 검토 후 빠르게 반영되므로, 원하는 서비스가 없다면 직접 기여해보는 것도 좋은 방법입니다.
결론 — 케이-스킬로 반복 작업에서 해방되기
‘한국인인가요? 이 스킬 모음집을 다운로드 받아 두세요. 언젠가 무조건 쓸 때가 옵니다!’ — 케이-스킬 프로젝트 소개 중
정리하면, 케이-스킬 사용법의 핵심은 다운로드 → 구조 파악 → 에이전트 연동 → 실행 → 커스터마이징이라는 5단계에 집약됩니다. SRT 예매부터 홈택스 조회까지, 한국인이 반복적으로 수행하는 작업을 AI 에이전트에게 위임하면 주당 수 시간의 시간을 절약할 수 있습니다.
이 가이드에서 다룬 핵심 사항을 다시 한번 정리하겠습니다.
- 케이-스킬은 10가지 이상의 한국 서비스를 자동화하는 오픈소스 스킬 모음집이다
- Claude Code·Codex·OpenCode와 호환되며 코딩 없이 활용 가능하다
.env파일을 통한 인증 정보 관리와.gitignore설정이 보안의 핵심이다
결론적으로, 코딩 에이전트 시대에 한국 서비스 자동화라는 틈새를 정확히 메워주는 프로젝트가 바로 케이-스킬입니다. 지금 바로 긱뉴스 프로젝트 페이지에서 저장소를 확인하고 첫 번째 스킬을 실행해보세요. 여러분은 어떤 서비스를 가장 먼저 자동화해보고 싶으신가요?
관련 글
이 글은 특정 제품이나 서비스에 대한 구매 권유가 아니며, 작성 시점 기준 공개 정보에 기반한 참고용 분석입니다. 제품·서비스 선택은 본인의 판단과 책임 하에 이루어져야 합니다.
🤖 AI 생성 콘텐츠 고지: 이 글은 AI 도구의 도움을 받아 작성되었으며, 편집팀이 검토·보완했습니다. 정보의 정확성을 위해 공식 출처를 함께 확인하시기 바랍니다.
이 글의 초안 작성에 AI 도구가 활용되었으며, 게시 전 사실 확인 및 검토를 거쳤습니다. (콘텐츠 작성 방식)
답글 남기기