Lakehouse Agent Skills는 코딩 에이전트가 데이터를 먼저 점검하고 정리한 뒤 차트와 대시보드를 만들도록 안내하는 오픈소스 도구 모음이다. 15개 스킬과 9개 명령, 4개 검토 하위 에이전트로 구성되며, 결과에서 다루지 못한 데이터도 명시하도록 설계됐다.
작업은 데이터 프로파일링, 정리, 모델링, 질의, 시각화, 대시보드 구성, 결과 서술, 한계 공개 순서로 진행한다. /profile 같은 명령으로 단계를 직접 고르거나 요청 내용을 설명해 라우터가 적절한 단계를 선택하게 할 수 있다. 개인정보를 프로젝트 밖으로 보내기 전 검토하는 /redact는 모든 단계에 적용된다.
정리 전 원본 파일은 수정하지 않고, 정리 규칙과 영향을 받은 행 수를 기록한다. 처리 결과는 data/curated/ 아래 Parquet 형식으로 저장하며, 이후 단계는 이 데이터를 읽는다. 저장된 데이터 질의에는 서버 없이 Parquet를 다루는 DuckDB를, 행 단위 작업에는 Polars를 기본으로 안내한다. 다만 프로젝트에서 이미 데이터프레임 라이브러리를 쓰고 있다면 새 라이브러리를 추가하는 대신 기존 것을 사용하도록 한다. 스프레드시트 작업에는 서식·수식·병합 셀을 다루는 openpyxl을 안내한다.
도구가 제시하는 대시보드는 연결된 필터가 모든 패널에 적용되는 단일 HTML 파일이다. 차트 유형은 시각 정보를 얼마나 정확하게 읽을 수 있는지에 관한 기준을 따라 선택하며, 예를 들어 원형 차트의 조각이 9개인 경우 이를 거부하도록 설명한다. 대시보드를 구성하기 전에는 페이지가 답할 질문과 독자가 수행해야 할 일을 정하고, 그 질문에 기여하지 않는 패널은 제거 후보로 삼는다.
검토 하위 에이전트는 검토 대상의 내용을 수정하지 않는다. 검증된 사실과 주장된 내용을 구분하고, 결과의 산술과 백분율의 기준을 점검하며, 프로젝트 밖으로 나갈 필드를 분류한다. 또 페이지의 시각적 결정을 검토하되 실제로 페이지를 렌더링하지 않았다는 점을 밝힌다. 이 검토는 결과가 프로젝트 밖으로 나가거나 누군가가 결과에 따라 행동할 때 실행하며, 프로젝트 안에서 살펴보는 초기 검토에는 개입하지 않는다.
제작자는 Claude Code와 Gemini CLI에 명령을 제공하며, 스킬은 여러 코딩 도구에서 사용할 수 있다고 설명한다. 다만 모든 도구에서 실제 실행까지 검증한 것은 아니다. Claude Code와 opencode에서는 로딩을 처음부터 끝까지 확인했고, 다른 도구에서는 파일이 설치되는지 확인했을 뿐이라고 밝힌다. 파일이 도착했다는 사실만으로 스킬이 실행된 것은 아니다. Claude Code 전용 세션 훅은 데이터 공개 기록이 없거나 게시 페이지를 확인하지 않은 경우 작업 종료를 막는다.
저장소에는 결과 페이지의 수치를 원본 테이블과 대조하는 verify-output.sh도 포함된다. 이 검사는 페이지를 읽지만 렌더링하지 않으므로, 오류가 없어도 시각적으로 확인하지 못한 항목을 매번 출력한다. 테스트는 구조 검사, 53개 요청이 적절한 스킬로 연결되고 31개 요청은 연결되지 않는지 확인하는 평가, 결함을 심은 테스트 데이터로 실제 실행을 점검하는 방식으로 나뉜다. 요청 연결 평가의 현재 1순위 정확도는 100%라고 저장소는 설명한다.
설치 경로와 지원 범위는 도구마다 다르다. Claude Code에서는 플러그인으로 명령·하위 에이전트·훅까지 설치할 수 있고, 다른 도구에는 npx skills add LuynoxRD/lakehouse-agent-skills --skill '*' --agent <your-agent> -y 명령으로 스킬을 추가할 수 있다. 개별 스킬만 설치하면 공유 references/ 체크리스트는 함께 복사되지 않는다. 설치한 파일은 자동으로 갱신되지 않아 직접 업데이트해야 한다.
저장소는 에이전트가 파일의 과거 맥락을 알 수 없고, 읽지 못한 데이터를 다 읽은 것처럼 다룰 수 있으며, 생성한 페이지를 직접 렌더링해 볼 수 없다는 한계를 문제로 든다. 따라서 각 단계에서 무엇을 처리하고 건너뛰었는지 기록하도록 한다. 자세한 설치 조건과 지원 범위는 저장소와 설치 문서에서 확인할 수 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요