ktx 데이터 분석 워크플로우
ktx MCP로 연결된 데이터베이스를 탐색·질의하고, 실수 없는 SQL로 정확한 분석 답변을 만들어 주는 스킬입니다.
데이터·분석고급★ 1,532⑂ 99AI 점수 8/10마지막 업데이트: 2026. 7. 19.
무엇을 해주나
ktx MCP 도구(discover_data, entity_details, dictionary_search, sl_query, sql_execution, memory_ingest 등)를 순서대로 활용해 데이터 질문에 답하는 표준 절차를 Claude에게 심어 줍니다.
- 탐색 → 확인 → 계획 → 질의 → 검증 → 기록의 7단계 워크플로우를 강제해 테이블 이름을 추측하지 않게 합니다.
- 시맨틱 레이어(측정값·차원)를 원시 SQL보다 우선 사용하도록 유도해 지표 정의의 일관성을 지킵니다.
<sql_craft>섹션에 "실행은 되지만 답이 틀리는" SQL 실수를 방지하는 규칙이 대량으로 정리되어 있습니다: 팬아웃 조인으로 인한 합계 부풀림, 라벨용 조인을 INNER JOIN해서 행이 사라지는 문제, 문자열로 저장된 숫자(1.2K,$1,200)의 파싱, 누적합의 RANGE 프레임 함정, postgres/sqlite의 정수 나눗셈, 윈도우 함수 전 필터링, 매크로/마이크로 평균 구분 등.- 질문이 요구하는 출력 컬럼 목록을 SQL 작성 전에 확정하고, 마지막에 완결성 체크를 수행하게 합니다.
이런 분께 추천
- 이미 ktx CLI/MCP를 사용해 데이터 웨어하우스(BigQuery, Postgres, Snowflake 등)를 연결한 팀
- Claude에게 애드혹 SQL 분석을 맡기지만 숫자가 미묘하게 틀려서 고생한 데이터 분석가/엔지니어
- 지표 정의와 스키마 함정을 문서화해 팀 지식으로 축적하고 싶은 데이터 조직
활용 예시
- "지난달 지역별로 반품 상품이 포함된 주문 수는?" → 스킬이 라인 아이템을 먼저 주문 단위로 집계한 뒤 조인해, 반품이 2건인 주문을 두 번 세는 팬아웃 오류를 막습니다.
- "고객별 첫 주문 중 2024년 이후 건만 보여줘" → 윈도우를 전체 파티션에 계산한 뒤 외부 쿼리에서 필터링하여 "진짜 첫 주문"을 정확히 판별합니다.
- "매출 총액 알려줘"인데 금액이
'3M','$1,200','-'텍스트로 저장된 경우 → 접미사 스케일링과 센티넬 처리를 담은 CTE로 한 번에 정규화해 조용히 0이 되는 사고를 방지합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 Kaelio/ktx 의 packages/cli/src/skills/analytics 폴더를 내 ~/.claude/skills/ktx-analytics/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/Kaelio/ktx.git && mkdir -p ~/.claude/skills && cp -r ktx/packages/cli/src/skills/analytics ~/.claude/skills/ktx-analytics⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비: ktx CLI가 설치되어 있고, 분석할 데이터베이스 연결이 ktx MCP 서버에 등록되어 있어야 합니다. (연결이 없으면 이 스킬은 동작하지 않습니다.)
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/Kaelio/ktx.git - 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r ktx/packages/cli/src/skills/analytics ~/.claude/skills/ktx-analytics ~/.claude/skills/ktx-analytics/SKILL.md파일이 존재하는지 확인합니다.- Claude Code에서 ktx MCP 서버가 연결되어 있는지 확인합니다(
/mcp또는connection_list도구 호출). - Claude Code를 재시작한 뒤 "우리 웨어하우스에서 지난달 주문 수 알려줘"처럼 물어보면 스킬이 자동으로 발동합니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0