클로드 스킬즈(Claude Skills) 작동 원리와 직접 만드는 법 총정리

핵심 메시지

• 스킬즈는 AI 에이전트에게 주는 '온보딩 가이드'로, 특정 작업을 반복적으로 잘 수행하도록 가르치는 절차적 지식 패키지다.
• '점진적 공개(progressive disclosure)' 덕분에 수천 개의 스킬이 있어도 그 순간 필요한 스킬 하나의 내용만 컨텍스트 윈도우에 올라간다.
• 스킬즈는 공식·커스텀·파트너·조직 프로비저닝 4가지로 나뉘며, 진짜 가치는 내 업무 맥락을 담은 커스텀 스킬에서 나온다.
• 스킬은 하나의 작업 단위이고, 플러그인은 여러 스킬·커맨드·에이전트를 묶은 번들로 점점 SaaS 형태로 진화하고 있다.
• 스킬즈는 SKILL.md 마크다운 한 파일로 만들 수 있고, 2025년 12월 오픈 표준으로 공개돼 코덱스·VS 코드·커서·제미나이 CLI 등에서도 동작한다.

쉽게 이해하기

영상은 클로드에게 엑셀이나 PPT를 만들어 달라고 하면 알아서 그럴듯한 결과가 나오는 것이, 뒤에서 '스킬즈(Skills)'라는 시스템이 작동하기 때문이라고 설명한다. (진행자 '세모트만'은 AI로 제작된 캐릭터다.) 발표자는 스킬즈를 이해하고 직접 만들 줄 아는 사람과 모르는 사람의 AI 활용 격차가 앞으로 급격히 벌어질 것이라고 강조한다.

스킬즈는 신입사원에게 주는 온보딩 가이드에 비유된다. 시스템 프롬프트나 커스텀 GPT는 격리돼 맥락을 한꺼번에 다루기 어렵고, n8n·메이크 같은 자동화 플랫폼은 결정론적 워크플로우에 특화돼 있다. 스킬즈는 그 중간에서 에이전트에게 절차를 알려주면서도 스스로 개선·사람 개입이 가능하며, 하나의 에이전트가 수천 개의 스킬에 동시에 접근할 수 있다는 점이 결정적 차이다.

수천 개를 넣어도 컨텍스트가 터지지 않는 비결은 '점진적 공개'다. 도서관에서 카탈로그만 훑고 필요한 책만 꺼내듯, ①메타데이터 스캔(각 SKILL.md의 이름·설명 두 줄만 기억) ②스킬 매칭과 지시 사항 로드(요청과 맞는 스킬의 전체 내용을 그때 로드) ③참조 파일의 조건부 로드(스타일 가이드나 스크립트는 필요한 시점에) 순으로 작동한다. 그래서 실제로 올라가는 건 그 순간 필요한 스킬 하나뿐이다.

스킬즈는 네 종류다. 엑셀·워드·PPT·PDF 생성을 강화하고 자동 적용되는 공식 스킬즈, 내 업무에 특화해 직접 만드는 커스텀 스킬즈, 노션·피그마·아틀라시안 등이 만든 파트너 스킬즈, 관리자가 조직 전체에 배포하는 조직 프로비저닝 스킬즈다. 한편 스킬이 하나의 작업 단위라면, 플러그인은 여러 스킬과 커맨드·전용 에이전트·커넥터를 묶은 번들로, 버전 관리가 되며 점점 SaaS처럼 진화하고 있다.

발표자는 남이 만든 스킬을 가져다 쓰는 것으로 시작하되, 장기적으로는 내 회사 맥락·데이터·톤을 담은 커스텀 스킬이 진짜 가치를 만든다고 강조한다. 만드는 법의 핵심은 코딩 없이 SKILL.md 한 파일이다. 상단 YAML 프론트매터에 이름과 설명을 적고(설명이 곧 로드 여부를 결정하는 트리거이므로 구체적으로 써야 함) 아래에 마크다운으로 절차적 지시를 쓴다. 이 포맷은 2025년 12월 오픈 표준으로 공개돼 클로드 외 플랫폼에서도 동일하게 동작하며, 발표자는 스킬즈를 '내가 아는 것을 AI가 반복 실행할 수 있는 형태로 번역해 두는 그릇'이자 복리처럼 쌓이는 디지털 자산으로 정의한다.

주요 인사이트

• 스킬즈의 핵심 메커니즘인 '점진적 공개'는 메타데이터→지시 사항→참조 파일의 3단계 로드로, 컨텍스트 윈도우 부담 없이 수천 개의 스킬을 다루게 해 준다.
• 스킬의 description은 단순 설명이 아니라 클로드가 언제 그 스킬을 불러올지 판단하는 트리거이므로, 모호하면 좋은 지시를 써도 호출되지 않는다.
• 범용 스킬은 범용적 결과만 내므로, 내 데이터·브랜드 톤·판단 기준을 담은 커스텀 스킬이 차별적 가치를 만든다.
• 플러그인은 여러 스킬을 묶은 상위 번들이지만, 스킬은 단독으로도 작동하므로 우선 좋은 스킬을 만드는 데 집중하는 것이 맞다.
• 스킬즈가 오픈 표준으로 공개되면서 특정 도구에 종속되지 않는 '포터블한 전문성'이 되었고, 도구가 바뀌어도 축적한 도메인 지식은 남는다.

자주 묻는 질문

관련 AI 소식