클래스도산

AI·자동화 트렌드

Anthropic 에이전트 스킬 완전 정리, 기업 AI 자동화가 바뀌는 지점

Kevin2026-10-07 · ⏱ 7분

Anthropic '에이전트 스킬' 공개, 기업 AI 자동화의 무엇이 달라지나요

월요일 아침마다 같은 보고서 양식, 같은 검수 규칙을 또 붙여넣고 계신가요. "지난번 그 방식으로 해줘"가 안 통하는 건 모델이 둔해서가 아니라, 그 방식이 어디에도 저장돼 있지 않아서예요.

Anthropic 에이전트 스킬 완전 정리, 기업 AI 자동화가 바뀌는 지점 커버

달라지는 건 하나입니다. 업무 노하우가 프롬프트에서 버전 관리되는 폴더로 옮겨갑니다.

Anthropic은 2025년 10월 16일 에이전트 스킬을 공개했어요1. 발표로부터 1년 가까이 지난 지금, 같은 형식이 Claude Code와 Claude 앱, API/Agent SDK에서 함께 돕니다2.

에이전트 스킬(Agent Skills)이 정확히 뭔가요?

작업 절차·템플릿·스크립트를 폴더 하나에 담아두고, Claude가 필요할 때 스스로 꺼내 쓰는 기능입니다.

에이전트 스킬(Agent Skills)이 정확히 뭔가요? 개념 일러스트

폴더 중심에는 SKILL.md라는 마크다운 파일이 있고, 그 옆에 참고 문서·엑셀 템플릿·파이썬 스크립트를 함께 넣습니다. "우리 회사 월간 보고서는 이렇게 만든다"를 한 번 써두면, 다음부터는 호출어 없이도 맥락을 보고 그 스킬을 집어듭니다.

MCP와 헷갈리기 쉬운데 역할이 다릅니다. MCP(Model Context Protocol)는 모델을 사내 DB·Jira·Slack 같은 외부 시스템에 연결하는 규격이고3, 스킬은 그 연결된 도구를 어떤 순서로 쓸지 적어둔 절차 지식입니다. 경쟁 관계가 아니라 짝이에요.

보충. MCP는 주방에 가스와 칼을 들이는 일, 스킬은 레시피 카드입니다. 칼만 있으면 요리가 안 되죠 🙂

프롬프트·RAG·MCP와 비교하면 뭐가 다른가요?

재사용 단위가 "사람의 기억"에서 "폴더"로 바뀝니다. 그게 차이의 전부입니다.

방식재사용 단위실제로 막히는 지점
매번 프롬프트 작성사람의 기억담당자가 바뀌면 노하우가 함께 사라집니다
RAG 문서 검색참고 텍스트사실은 찾아주지만 실행 순서는 알려주지 않습니다
MCP 도구 연결시스템 접근 권한도구는 생기는데 쓰는 법은 매번 다시 설명합니다
에이전트 스킬폴더(절차+자료+코드)신뢰할 출처의 스킬만 설치해야 합니다

표의 오른쪽 칸은 공식 문서의 주장이 아니라, 네 방식의 구조에서 따라 나오는 편집 판단입니다. 다만 왼쪽 칸의 귀결은 분명해요. 폴더는 Git에 올라가고, 리뷰를 받고, 팀 전체에 배포됩니다. 프롬프트는 메신저에 떠돌다 사라지지만 스킬은 저장소에 남아요.

'점진적 공개'는 왜 컨텍스트를 아껴주나요?

스킬이 50개여도 평상시 컨텍스트에 올라가는 건 이름과 설명 한 줄씩, 50줄 분량이 전부입니다.

Anthropic이 설명하는 점진적 공개(progressive disclosure)는 정보를 세 단계로 흘립니다4.

  1. 상시 로드 — 각 스킬의 name과 description만 올려둡니다.
  2. 본문 열기 — 관련 작업이 들어오면 그 스킬의 SKILL.md 본문을 읽습니다.
  3. 깊게 파기 — 더 필요할 때만 폴더 안 참고 파일이나 스크립트를 엽니다.

공식 문서는 name을 64자, description을 1024자 이내로, 본문은 500줄 이내로 유지하라고 권고해요2. 사람이 사전을 쓰는 방식 그대로입니다. 색인을 보고 해당 쪽만 펼치는 거죠. 매뉴얼 전체를 매번 밀어 넣어 토큰과 정확도를 함께 깎아먹던 문제가 여기서 풀립니다.

비개발 조직도 스킬을 직접 만들 수 있나요?

네. SKILL.md는 코드가 아니라 마크다운 문서라서, 업무 절차를 글로 쓸 수 있으면 첫 스킬이 나옵니다. 스크립트가 붙는 고급 스킬엔 개발자 손이 필요하지만, 출발점은 "절차를 정확히 문서화했다"입니다.

클래스도산의 클로드 바이브 코딩 원데이 클래스도 같은 전제로 설계했어요. 비개발자가 5시간 안에 결과물 1개를 완성하는 수업인데, 여기서 쓰는 판정 기준이 스킬화 3조건입니다. 어떤 업무를 스킬로 만들지 고를 때 통과시켜야 하는 세 관문이에요.

  1. 반복성 — 월 2회 이상 돌아오나요? 1년에 한 번이면 그때 손으로 하세요.
  2. 절차 명확성 — 글로 적을 수 있나요? 베테랑 머릿속 감으로만 돌아가는 일은 문서화가 먼저입니다.
  3. 검증 가능성 — 결과가 맞았는지 누가 어떻게 확인하나요? 검수 기준 없는 자동화는 틀린 걸 빠르게 만들어낼 뿐이에요.

세 개를 다 통과하는 업무부터 손대세요. 파일럿이 깨지는 자리는 거의 늘 2번과 3번입니다.

도입 전 점검표: 무엇을 확인하나요?

점검 항목통과 기준
스킬 출처공식 저장소(anthropics/skills) 또는 사내 코드리뷰를 통과한 스킬만 설치5
권한 범위스킬이 호출하는 MCP·도구를 해당 업무 1건에 필요한 범위로 제한
버전 관리폴더 전체가 Git 저장소에 있고, 변경마다 승인자 1명이 기록됨
검수 지점외부 발송·결제·배포 직전에 사람 승인 1단계가 명시됨

출발점은 보안입니다. 스킬은 실행 스크립트를 품을 수 있어서5, 출처 불명 스킬을 설치하는 건 출처 불명 실행 파일을 받는 것과 같은 급으로 다뤄야 합니다.

4주 파일럿, 어떻게 돌리나요?

한 팀, 한 업무, 4주. 이보다 넓히면 파일럿이 아니라 프로젝트가 되고, 승인 절차부터 길어집니다.

4주 파일럿, 어떻게 돌리나요? 개념 일러스트

필요한 역할은 셋입니다. 현업 담당자가 절차를 받아쓰고, AI 담당자가 SKILL.md로 다듬고, 보안 담당자가 권한과 검수 지점을 확인합니다. 측정은 "AI를 썼다"가 아니라 건당 처리 시간과 재작업률로 하세요. 이 두 숫자가 안 움직이면 스킬이 아니라 업무 정의가 문제입니다.

한눈 요약

  1. 에이전트 스킬은 절차·자료·코드를 담은 폴더이고, Claude가 맥락을 보고 스스로 꺼내 씁니다.
  2. 공개일은 2025년 10월 16일, 지원 환경은 Claude Code·Claude 앱·API/Agent SDK입니다.
  3. 점진적 공개 3단계로 평상시엔 이름과 설명만 로드합니다.
  4. 스킬화 3조건은 반복성·절차 명확성·검증 가능성입니다.
  5. 보안 검토의 핵심은 출처 검증과 사람 승인 지점 1곳입니다.

반복 설명이 사라진 자리에 무엇을 채울지가 담당자의 실력이 됩니다. 이번 주에 가장 많이 설명한 업무 하나를 골라 3조건에 대보시고, 직접 만들어 보고 싶으시면 원데이 클래스에서 결과물 1개까지 같이 만들어요.

자주 묻는 질문

Q. 스킬을 쓰려면 기존 프롬프트 자산을 버려야 하나요? A. 아니요. 잘 쓰던 긴 프롬프트가 가장 좋은 스킬 초안입니다. 머리말에 name과 description만 붙여 폴더로 옮기면 출발점이 됩니다.

Q. 스킬과 RAG는 같이 쓸 수 있나요? A. 같이 씁니다. RAG는 "무엇이 사실인가", 스킬은 "어떤 순서로 처리하는가"를 맡아요. 스킬 본문에서 사내 검색 도구를 호출하도록 적어두면 한 흐름에서 돕니다.

Q. 스킬이 많아지면 Claude가 엉뚱한 걸 고르지 않나요? A. 선택 품질은 description에 거의 다 달려 있습니다. "언제 쓰는 스킬인지"를 조건까지 적으세요. 비슷한 스킬이 둘 이상이면 합치는 편이 낫습니다.

Q. 보안팀 승인을 받으려면 무엇을 준비하나요? A. 스킬 목록, 각 스킬이 접근하는 시스템과 권한, 변경 승인 절차, 사람 검수 지점. 이 네 가지면 대화가 시작됩니다.

출처

이번 세션에서도 웹 검증 도구를 쓰지 않았습니다. 출처는 제가 확실히 아는 Anthropic 1차 자료로만 한정하고, 수치는 공식 문서에 명시된 항목(name 64자·description 1024자·SKILL.md 500줄 권고)과 발표일만 썼습니다. 발행 전 URL 5개는 한 번 눌러서 확인해 주세요.

Footnotes

  1. Anthropic, 『Introducing Agent Skills』 (2025년 10월 16일 발표) — https://www.anthropic.com/news/skills ↩

  2. Anthropic, 『Agent Skills』 공식 문서 (SKILL.md 포맷, 길이 권고, 지원 환경) — https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview ↩ ↩2

  3. Model Context Protocol 공식 사이트 (모델–외부 시스템 연결 규격) — https://modelcontextprotocol.io ↩

  4. Anthropic Engineering, 『Equipping agents for the real world with Agent Skills』 (점진적 공개 설계 원리) — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills ↩

  5. anthropics/skills GitHub 저장소 (공개 스킬 예시 및 작성 규격) — https://github.com/anthropics/skills ↩ ↩2