바이브코딩을 시작한 지 얼마 되지 않아 아직 낯설고 모르는 것도 많습니다.
그래서 처음부터 거창한 자동화를 만들기보다는,
업무를 하면서 매번 번거롭게 느껴졌던 부분부터 하나씩 정리하며
바이브코딩에 익숙해져 보자는 목표로 비교적 쉬운 스킬부터 만들어보기로 했습니다.
저는 appscript 를 사용해서 원하는 데이터를 자동으로 가지고 오며 업무 효율을 향상하기 위해 고민하고 있습니다. appscript를 바이브코딩으로 짜는 중에 계속 발생하는 문제가 하나 있는데요.
제가 믹스패널(Mixpanel) 데이터를 추출하기 위해 프롬프트를 작성하면, claude code나 gpt는 유료 플랜을 전제로 JQL(Query API) 기반 분석의 방식의 가이드를 기본값처럼 제안 주는데, 현재 저희 서비스는 무료플랜으로 믹스패널을 이용하고 있어서 데이터를 우회하여 가져오는 방법으로 스크립트가 구현되어야 했던 것이었습니다. 저는 JQL 이라는 표현도 낯선 비개발자라 시키는 대로 진행하다가 막히고 다시 하고를 몇번 반복하곤 했습니다.
이후로는 경험을 기반으로 배운 지식을 바탕으로 믹스패널 관련한 데이터를 뽑을 때마다 “무료 플랜이기 때문에 JQL은 쓰지 말고, Export API로 진행해달라”는 동일한 지침을 설명하게 되었습니다. 그런데 이렇게 처음 알려준 지침도 작업이 오래 진행되면 claude code 가 다시 데이터를 JQL 로 가져오기 위해 시도할 때도 있더군요.
그래서 이 과정을 매번 프롬프트로 설명할 게 아니라, Claude skills 로 만들어서 제가 믹스패널 관련한 요구를 하면 무조건 이 지침을 따르도록 하면 좋겠다고 생각하고 시도해보게 되었습니다.
1. GPT 5.2 활용해보기
저는 스킬을 만드는 것도 그렇고 심지어 사용해본 적도 없어서 GPT 한테 이런 부분부터 제가 이해할 수 있게 요구하였습니다.
이 과정에서는 GPT 5.2 를 사용해보았는데요. 답변시간이 정말 오래 걸리는 만큼 가이드를 아주 세세히 주었습니다.
2. SKILL.md 가 저장될 폴더 생성 및 skill.md 생성
스킬을 만들 때 필수로 들어가야하는 요소라든지, 어떻게 작동하는지 gpt에게 들으면서 폴더를 만들고, 그 안에 md 를 만드는 것까지 함께 하였습니다.
GPT 가 짜준 MD 지침을 읽어보면서 제가 이해가 안 되는 부분은 물어보기도 하구요, 또 원하는 것과 방향이 다르면 다시 고치기도 하였습니다.
3. 스킬이 제대로 설치된 건지 확인
스킬이 제대로 설치된 건지도 GPT의 가이드대로 VS code 에서 확인해보았습니다.
그런데 막상 사용하려고 해보니까 skill 이 발동(?)/ 사용(?)되기 위한 지침을 제가 생각보다 어렵게 해두었더라구요.
제가 원한 건 내가 하는 믹스패널을 가지고 하는 모든 데이터 추출 활동은 무조건 export api 활용해서 진행하게 되게 하고 싶은데, 꼭 그렇게 디테일하게 표현해야만 skill이 발동되는 상태였습니다.
그래서 제가 가이드를 더 넓은 표현으로 믹스패널의 데이터를 갖고오라는 말만 있어도 스킬을 사용하도록 지침을 수정해달라고 했습니다.
그래서 위와 같은 md 파일이 완성되었습니다.
4. 활용해보기
MD 파일을 저장하고 VS Code를 껐다가 킨 다음에 제가 활용할 수 있는 스킬을 찾아보니 이렇게 나오더라구요.
그리고 바로 스킬이 사용될 수 있도록 claude code에 믹스패널 관련한 요청을 하니 위와 같이 Skill 이 사용되었습니다.
이 스킬로 인해 이제 요청할 때마다 제가 챙기지 않아도 동일한 방식으로 믹스패널의 데이터를 불러오는 활동을 할 수 있을 것 같네요.
저도 이제 스킬을 하나 갖게 되었습니다.
결과와 배운 점
스킬, MCP 등 꼭 알아야 할 도구(?)들이지만 얼핏 듣기만하고 직접 사용해보지 않으니 어떻게, 언제 활용해야하는 건지 잘 와닿지 않고 막막했는데요.
이렇게 제 업무에 필요한 부분을 가지고 적용해보니 어떤 식으로 활용되는지 좀 더 잘 이해가 되었던 것 같아요. 이 과정에서 JQL 이라든지, YAML 이라든지.. 회의 때 눈만 뻐끔거리며 귀동냥 했던 것들에 대한 내용에 대해서도 어렴풋이 알게 된 것도 의미가 있었습니다.
