클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

SQL 쿼리 작성 도우미

단순 조회부터 복잡한 다중 테이블 JOIN·집계까지 SQL을 계획·작성·실행하도록 안내하는 스킬.

데이터·분석중급19813AI 점수 8/10마지막 업데이트: 2026. 8. 6.

무엇을 해주나

  • 질문을 받으면 필요한 테이블을 찾고 스키마를 확인한 뒤 SQL을 작성·실행하는 절차를 따릅니다.
  • 단순 쿼리와 복잡 쿼리를 구분해 워크플로를 제시하며, 복잡한 경우 할 일(todo) 분해 → 스키마 확인 → JOIN 설계 → 검증 → 실행 순으로 진행합니다.
  • 빈 결과, 문법 오류, 타임아웃 등 실패 상황별 복구 지침을 제공합니다.
  • 품질 규칙: SELECT * 금지, 기본 LIMIT 5, 테이블 별칭 사용, INSERT/UPDATE/DELETE/DROP 같은 DML 절대 금지.

이런 분께 추천

  • DB에 연결된 Claude 에이전트로 데이터 조회·리포트를 만들고 싶은 데이터 분석가
  • SQL을 자주 쓰지만 JOIN·GROUP BY 구조에서 실수가 잦은 개발자
  • 자연어 질문을 SQL로 바꾸는 text-to-SQL 에이전트를 구성하는 분

활용 예시

  • "국가별 매출 상위 5개를 뽑아줘" → Invoice와 Customer를 JOIN해 SUM·GROUP BY·ORDER BY·LIMIT이 적용된 쿼리 생성·실행
  • "지난달 가입한 고객 목록 보여줘" → 단일 테이블 스키마 확인 후 WHERE·ORDER BY가 들어간 SELECT 실행
  • 쿼리가 빈 결과를 반환할 때 → 컬럼명 대소문자, NULL, WHERE 조건을 순서대로 점검해 원인 파악

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/Idun-Group/idun-agent-platform/HEAD/examples/tutorials/text-to-sql-deep-agent/skills/query-writing/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 Idun-Group/idun-agent-platform 의 examples/tutorials/text-to-sql-deep-agent/skills/query-writing 폴더를 내 ~/.claude/skills/query-writing/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/Idun-Group/idun-agent-platform.git && mkdir -p ~/.claude/skills/query-writing && cp -r idun-agent-platform/examples/tutorials/text-to-sql-deep-agent/skills/query-writing/* ~/.claude/skills/query-writing/

제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/Idun-Group/idun-agent-platform.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills/query-writing
  4. 파일을 복사합니다: cp -r idun-agent-platform/examples/tutorials/text-to-sql-deep-agent/skills/query-writing/* ~/.claude/skills/query-writing/
  5. sql_db_query, sql_db_schema 같은 DB 도구(예: MCP 데이터베이스 서버)를 Claude Code에 연결합니다. 이 도구가 없으면 쿼리 실행 단계가 동작하지 않습니다.
  6. Claude Code를 재시작하고 "매출 상위 국가를 SQL로 뽑아줘"처럼 요청해 스킬이 발동하는지 확인합니다.
GitHub에서 원본 보기라이선스: GPL-3.0