자동화 대세 클로드 스킬! 제작부터 배포까지 전부 알려드립니다
📺 원본 영상: 자동화 대세 클로드 스킬! 제작부터 배포까지 전부 알려드립니다 🎙️ 채널: 시민개발자 구씨 📅 정리 일자: 2026-03-14 ⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.
개요
Claude Code를 활용하다 보면 같은 요청을 반복해도 매번 다른 결과물이 나오는 일관성 문제에 부딪히게 된다. 이 영상에서 시민개발자 구씨는 이 문제의 근본적인 해결책으로 Claude Skills를 제시하며, 스킬 제작부터 Eval(Evaluation) 테스트를 통한 성능 검증, 플러그인 패키징, Claude.ai 배포까지의 전 과정을 실습 중심으로 설명한다. 단순한 프롬프트 엔지니어링을 넘어, AI에게 체계적인 SOP(Standard Operating Procedure, 표준 운영 절차) 업무 매뉴얼을 제공하는 방식으로 자동화 시스템을 구축하는 방법론을 다루고 있다.
Claude Skills란 무엇인가: AI에게 주는 SOP 업무 매뉴얼
강연자는 Claude Skills를 한마디로 “AI에게 주는 SOP 업무 매뉴얼”로 정의한다. 회사에 신입사원이 들어왔을 때 구두로만 지시를 내리면 일관된 결과물을 기대하기 어렵듯이, AI도 마찬가지라는 논리다. 업무 매뉴얼을 체계적으로 작성해 주면 신입사원이 온보딩을 거쳐 일관된 결과물을 낼 수 있는 것처럼, Claude Skills는 AI가 동일한 방식으로 반복 업무를 수행할 수 있게 해주는 기반을 제공한다.
강연자는 Claude Skills를 n8n Workflow와 비교하며 구조적 유사성을 설명한다. n8n에서는 트리거가 조건에 따라 노드를 실행하고, 그 뒤에 다양한 액션이 순서대로 이어지며 최종 아웃풋을 만들어낸다. Claude Skills에서는 Description 필드가 트리거 역할을 하고, skill.md 본문이 일련의 액션과 프로세스를 정의하며, 추가 참고 문서와 스크립트가 세 번째 레이어로서 필요할 때만 선택적으로 로드된다. 구조는 다르지만, n8n으로 Workflow를 구성해서 달성하려는 목표를 Claude Skills로도 동일하게 실현할 수 있다는 것이 강연자의 핵심 주장이다.
skill.md의 3계층 구조: 토큰 효율과 일관성의 설계
Claude Skills의 핵심 설계 원리는 skill.md 파일 내에 구성된 3계층 구조에 있다. 강연자는 이 구조가 토큰 효율성과 결과의 일관성을 동시에 확보하기 위해 의도적으로 설계된 방식임을 강조한다.
첫 번째 계층은 스킬의 이름(Name)과 설명(Description)으로 구성된다. 이 계층은 Claude가 항상 처음에 로드하는 부분으로, 용량이 매우 작아 토큰 소모가 극히 적다. CLAUDE.md에 해당 skill.md의 존재와 트리거 조건을 등록해두면, 설명에 해당하는 프롬프트가 입력될 때 자동으로 스킬이 활성화된다.
두 번째 계층은 skill.md 본문이다. 스킬이 트리거된 이후에야 로드되며, 실제 업무 지침, 처리 프로세스, 아웃풋 포맷, 검증 체크리스트 등이 담긴다. Claude는 이 두 번째 계층에 정의된 절차를 따라 자동화 프로세스를 단계적으로 진행하게 된다.
세 번째 계층은 추가 참고 자료다. 업무를 진행하는 과정에서 필요할 때만 선택적으로 로드되며, 출력 템플릿, 참고 문서, 실행 스크립트 등이 여기에 해당한다. 특히 PDF 생성이나 특정 포맷 유지가 필요할 경우 Python 스크립트를 이 계층에 포함시켜 코드를 직접 실행하는 방식으로 결과의 일관성을 극대화할 수 있다.
이 설계의 핵심은 Claude가 항상 첫 번째 계층만 먼저 로드한다는 점이다. 여러 개의 스킬을 프로젝트에 등록해도 각 스킬의 첫 번째 계층만 메모리에 상주하기 때문에 토큰을 효율적으로 사용하면서, 필요한 스킬이 호출될 때만 나머지 계층을 로드해 전체적인 성능과 일관성을 동시에 유지할 수 있다.
💡 [영상 참조] 강연자는 이 시점에서
skill.md파일의 실제 내용과 3계층 구조가 어떻게 구성되는지 화면을 통해 직접 보여줍니다. 📺 원본 영상에서 확인하세요.
프롬프트 엔지니어링과의 세 가지 핵심 차이점
Claude Skills를 단순히 “잘 만든 프롬프트”와 동일시해서는 안 된다. 강연자는 이 둘 사이에 세 가지 근본적인 차이가 있다고 설명한다.
첫째는 재사용성이다. 프롬프트는 매번 복붙해서 실행해야 하지만, 스킬은 한 번 정의해두면 트리거 문구만으로 자동 실행된다. 복잡한 지시사항을 매 세션마다 반복 입력할 필요가 없다는 점에서 실용적 우위가 크다.
둘째이자 강연자가 가장 중요하다고 꼽은 차이는 일관성이다. 프롬프트가 길고 복잡해질수록 AI가 모든 지침을 빠짐없이 반영한 일관된 결과물을 내놓는 데 한계가 발생한다. 반면 스킬은 3계층 구조와 참고 문서, 나아가 코드 스크립트를 통해 코드를 직접 실행하여 결과물을 반환하기 때문에, 결과의 일관성을 확보하는 데 있어 구조적으로 유리하다.
셋째는 확장성이다. 프롬프트가 텍스트나 이미지 위주의 입력에 머무는 반면, 스킬은 코드 스크립트, 참조 문서, 서브 에이전트(Sub-agent)까지 통합할 수 있어 훨씬 복잡한 프로세스를 다양한 포맷으로 구현할 수 있다. 강연자는 이를 비유하여, 프롬프트가 n8n에서 하나의 노드 설정을 돕는 기능이라면, 스킬은 전체 Workflow를 구성해주는 기능이라고 표현한다. 간단한 한두 번의 요청에는 프롬프트로 충분하지만, 반복 실행할 자동화 시스템을 구축하고자 한다면 스킬이 필수적인 이유가 바로 여기에 있다.
실습: 견적서 자동 생성 스킬 제작
개발 환경 준비
강연자는 VS Code의 터미널에서 Claude Code CLI를 실행하는 방식으로 작업을 진행한다. 확장(Extension) 패널에서 Claude Code for VS Code를 설치해 우측 패널로 사용하는 방법도 있지만, 강연자는 더 다양한 기능을 빠르게 활용할 수 있다는 이유로 터미널 버전을 선호한다. Claude Code 실행 시 --dangerously-skip-permissions 옵션을 추가하면 매번 권한 요청 없이 자동으로 실행되어 빠른 반복 작업에 유리하다.
💡 [영상 참조] 강연자는 VS Code에서 Claude Code를 터미널로 실행하는 전체 화면을 직접 보여줍니다. 📺 원본 영상에서 확인하세요.
Skill Creator 플러그인 설치
스킬을 직접 skill.md 파일로 작성할 수도 있지만, Anthropic이 공식 제공하는 Skill Creator 플러그인을 활용하면 훨씬 쉽게 스킬을 제작할 수 있다. Claude Code에서 /plugin을 입력하면 마켓플레이스가 열리며, 여기서 Skill Creator를 검색해 설치한 후 재시작하면 /skill-creator 명령어로 스킬 제작 보조 기능이 활성화된다. 플러그인이 보이지 않을 경우 Claude 마켓플레이스 사이트에 접속하여 플러그인 URL을 직접 추가하는 방법도 있으며, 플러그인 하나에 여러 스킬과 MCP 도구 등을 함께 패키징할 수 있다.
견적서 스킬 생성 요청
이번 실습의 목표는 프리랜서나 에이전시가 고객에게 보내는 견적서 초안을 자동으로 생성하는 스킬을 만드는 것이다. 매번 템플릿을 찾아 항목을 채우고 금액을 계산하는 반복 작업을 자동화하기 위해, 먼저 reference 폴더에 견적서 포맷 PDF 템플릿(invoice-template.pdf)을 추가하고, 이를 참고 자료로 활용하도록 스킬 생성을 요청했다. 요청 내용에는 고객사명·프로젝트 내용·업무 항목·단가 입력 시 견적서 초안을 생성하는 기능, PDF 파일 출력, 자체 검증 체크리스트 포함, 자동 트리거 조건 지정 등이 담겼다. 또한 스킬 제작 직후 Eval 테스트도 함께 실행해달라고 요청했다.
💡 [영상 참조] 강연자는
invoice-template.pdf가 추가된reference폴더 구조와, Claude Code에 입력한 스킬 생성 프롬프트 전문을 화면으로 보여줍니다. 📺 원본 영상에서 확인하세요.
생성된 skill.md에는 1단계(고객 정보 수집) → 2단계(JSON 데이터 준비) → 3단계(PDF 생성)의 프로세스가 정의되었고, PDF 생성에는 Python 스크립트가 세 번째 계층의 리소스로 활용되었다. 검증 체크리스트가 포함되어 생성된 견적서에서 누락 항목이 없는지 자동으로 점검하며, 최종 파일 경로를 사용자에게 안내하는 워크플로우까지 한 번에 완성되었다.
Eval 테스트: A/B 테스트로 스킬 성능 검증
Eval 테스트란
Eval(Evaluation) 테스트는 Skill Creator에 내장된 A/B 테스트 기능으로, 스킬 사용 전후의 성능 차이를 정량적으로 비교한다. evals.json에 정의된 3개의 테스트 케이스를 기반으로, 스킬을 활용한 경우 3회와 스킬 없이 요청한 경우 3회를 병렬로 실행(총 6회)하여 결과물의 품질, 처리 시간, 토큰 사용량 등을 비교 분석해 준다. 테스트가 완료되면 자동으로 알림을 받고, 그레이딩과 벤치마크 리포트가 생성된다.
첫 번째 Eval 결과
스킬을 활용한 케이스에서는 미리 제공한 invoice-template.pdf의 구조를 반영하여 일관된 레이아웃의 견적서가 생성되었으며, 검증 체크리스트의 모든 항목이 충족되었다. 반면 스킬 없이 요청했을 때는 케이스마다 디자인이 달라졌고, 입금 계좌 정보 등 필수 항목이 누락되는 등 일관성이 크게 떨어졌다. 3개 케이스 모두에서 스킬 사용 시에는 동일한 포맷이 유지된 반면, 스킬 미사용 시에는 매번 다른 디자인이 임의로 출력되어 뚜렷한 차이를 확인할 수 있었다.
피드백과 스킬 개선
첫 번째 Eval 결과를 리뷰한 후, 강연자는 일관성은 확보되었지만 디자인이 만족스럽지 않다는 피드백을 남겼다. 이를 개선하기 위해 reference 폴더에 브랜드 디자인 가이드라인 문서를 추가하고, 이 가이드라인에 맞춰 PDF 디자인을 수정해달라는 요청을 피드백으로 입력했다. 요청 내용에는 메인 컬러(주황색) 적용, 폰트 가이드라인 준수, 헤더/푸터에 회사 정보 삽입, 전문적이고 깔끔한 레이아웃 구성이 포함되었다. 강연자는 본인뿐만 아니라 회사 브랜드 디자인 가이드라인 문서를 마찬가지 방식으로 추가하면 동일하게 활용할 수 있다고 덧붙였다.
Submit All Reviews 버튼을 누르면 피드백이 feedback.json 파일로 로컬에 자동 저장된다. 이후 Claude Code에 “피드백을 반영해서 스킬을 업데이트해줘”라고 요청하면, Claude가 자동으로 feedback.json을 검색·로드하여 스킬을 수정하고, 두 번째 Eval 테스트를 자동으로 실행한다.
두 번째 Eval 결과와 벤치마크
두 번째 테스트에서는 브랜드 가이드라인의 주황색이 반영된 일관된 디자인의 견적서가 생성되었다. 뷰어는 이전 출력(Previous Output)과 현재 결과를 나란히 비교할 수 있도록 설계되어 있어 개선 여부를 직관적으로 확인할 수 있었다. 벤치마크 수치를 보면, 스킬을 활용했을 때 처리 시간이 약 34초인 반면 스킬 미사용 시에는 약 147초(±60초)가 소요되어 처리 속도가 대폭 향상되었다. 토큰 사용량도 스킬 사용 시 더 효율적이었으며, 마지막에는 전체 테스트 결과를 요약한 분석 노트도 자동으로 생성되었다.
💡 [영상 참조] 강연자는 Eval 뷰어 화면, 스킬 유무 결과물 비교 화면, 그리고 처리 시간과 토큰 수치가 담긴 벤치마크 비교 화면을 직접 보여줍니다. 📺 원본 영상에서 확인하세요.
스킬 등록 및 플러그인 패키징과 배포
.claude 폴더에 스킬 등록
완성된 스킬을 Claude Code의 /skills 명령어로 사용하려면, .claude/skills/ 경로에 스킬 폴더를 위치시켜야 한다. 해당 폴더를 생성하고 스킬을 배치한 뒤 Claude Code를 재시작하면, /skills에서 Quote Generator 스킬이 80 토큰으로 등록된 것을 확인할 수 있다. 이 80 토큰은 skill.md의 첫 번째 계층인 Description의 크기로, 항상 메모리에 상주하는 경량 데이터임을 의미한다. 이후 “quote generator ABC 회사 100만원 AI 자동화건 견적서 만들어줘”처럼 간단한 프롬프트를 입력하면 스킬이 자동으로 트리거되어 견적서가 생성된다.
로컬 마켓플레이스 생성과 플러그인 등록
단일 프로젝트를 넘어 여러 프로젝트에서 동일한 스킬을 재사용하려면 플러그인 형태로 패키징하는 것이 효율적이다. 강연자는 Anthropic 공식 문서의 마켓플레이스 생성 및 배포 가이드를 Claude Code에 직접 붙여넣어 참고 자료로 제공한 뒤, “Citizen Dev 마켓플레이스를 생성하고 Quote Generator 스킬을 플러그인으로 등록해줘”라고 요청했다. 공식 문서를 함께 제공하는 이 방식은 Claude가 공식 형식에 맞게 정확히 제작할 수 있도록 돕는다.
생성된 플러그인의 폴더 구조는 크게 두 가지로 나뉜다. .claude-plugin 폴더에는 마켓플레이스 정보(marketplace.json)와 플러그인 메타 정보가 저장되고, plugins 폴더에는 실제 스킬 파일들이 패키지로 포함된다. 이후 Claude Code의 /plugin → Add Marketplace 메뉴에서 로컬 마켓플레이스 경로를 등록하면 Quote Generator 플러그인을 손쉽게 설치할 수 있게 된다. GitHub에 마켓플레이스를 올려두면 URL로도 플러그인을 추가할 수 있어 팀 단위의 공유에도 유용하다.
Claude.ai 앱에서 ZIP 플러그인 설치
Claude.ai 데스크탑 앱에서도 동일한 스킬을 활용하고 싶다면 별도의 설치 과정이 필요하다. 강연자는 Claude Code에 “Claude.ai에서 설치하기 쉽게 ZIP 파일로 플러그인을 패키징해줘”라고 요청하여 ZIP 형태의 패키지를 생성했다. Claude.ai 데스크탑 앱을 열고 Projects에서 Working 폴더를 지정한 뒤, /plugin → Personal → Upload Plugin 메뉴에서 생성된 ZIP 파일을 업로드하면 설치가 완료된다. 업로드 후에는 폰트 에셋, 레퍼런스 문서, Python 스크립트 등 스킬의 모든 구성 요소가 정상적으로 로드된 것을 확인할 수 있으며, 이후 Claude.ai 인터페이스에서도 동일한 방식으로 견적서 생성을 요청할 수 있다.
💡 [영상 참조] 강연자는 Claude.ai 앱에서 플러그인 업로드 화면과 스킬의 모든 구성 요소가 로드된 화면, 그리고 스킬을 활용하여 견적서가 생성되는 전 과정을 보여줍니다. 📺 원본 영상에서 확인하세요.
마무리 / 핵심 정리
Claude Skills는 AI에게 체계적인 SOP 업무 매뉴얼을 제공함으로써 반복적인 업무에서 일관성 있는 결과물을 만들어내는 자동화 도구다. 이번 영상에서 강연자가 실제로 증명한 것처럼, 스킬을 활용하면 처리 시간을 대폭 단축하고(34초 vs 147초) 토큰 효율도 개선하면서 동시에 결과의 품질과 일관성을 높일 수 있다.
그러나 몇 가지 주의할 점이 있다. Description을 제대로 작성하지 않으면 스킬이 트리거되지 않는 경우가 발생할 수 있고, .claude/skills/ 폴더 구조를 올바르게 설정하지 않으면 스킬 자체가 등록되지 않을 수 있다. 또한 skill.md에 정의된 프로세스가 불명확하면 Workflow 실행 결과가 기대에 미치지 못할 수 있다. 강연자는 이러한 트러블슈팅 관련 가이드 문서를 영상 설명란에 제공할 예정이라고 밝혔다.
Skill Creator를 통한 자동 생성, Eval 테스트를 통한 객관적 성능 검증과 피드백 기반 반복 개선, 플러그인 패키징을 통한 재사용성 확보라는 세 단계를 거치면, 나만의 업무 자동화 시스템을 체계적으로 구축할 수 있다. 단순한 한두 번의 요청에는 프롬프트로도 충분하지만, AI를 활용해 반복적으로 실행할 자동화 시스템을 구축하고자 한다면 Claude Skills는 필수적인 선택이 될 것이다.
📚 출처 및 참고
| 구분 | 내용 |
|---|---|
| 원본 영상 | 자동화 대세 클로드 스킬! 제작부터 배포까지 전부 알려드립니다 |
| 채널 | 시민개발자 구씨 |
| 리포트 작성 | 2026-03-14 |
| 작성 방식 | YouTube 영상 STT 변환 후 에디팅 |
💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.