클로드(Claude) Agent Skills 활용법: 설정부터 실전 활용까지

보고서 양식, 회의록 포맷, 발표 자료 디자인처럼 매번 똑같은 형태로 반복해서 만드는 문서가 있으신가요? AI에게 매번 ‘지난번처럼 만들어줘’라고 설명해도 결과물이 조금씩 달라져 답답했던 경험이 있을 수 있습니다. 클로드(Claude)의 ‘Agent Skills’는 이런 반복 작업의 방식 자체를 폴더 하나에 고정해두고 계속 재사용할 수 있게 해주는 기능입니다.

이 글에서는 Anthropic 공식 문서(Agent Skills Overview)를 기준으로, Agent Skills의 내부 파일 구조(SKILL.md)까지 직접 뜯어보고 요금제별 비용, 설정 방법, 실전 활용까지 순서대로 정리했습니다.

클로드 Agent Skills란 무엇인가

Agent Skills는 특정 작업을 더 잘 수행하도록 지침·스크립트·참고 자료를 폴더 하나로 묶어둔 것입니다. 클로드는 평소에는 스킬의 ‘이름과 설명’만 가볍게 시스템 프롬프트에 올려두고 있다가, 실제로 관련된 요청이 들어오면 그때 전체 지침을 불러와 작업에 활용합니다. Anthropic은 이 방식을 ‘프로그레시브 디스클로저(progressive disclosure)’라고 부르며, 로딩 단계를 아래처럼 3단계로 구분합니다.

단계	로드 시점	토큰 비용	내용
1단계: 메타데이터	항상(시작 시)	스킬당 약 100토큰	YAML의 name·description
2단계: 본문 지침	스킬이 트리거될 때	5,000토큰 미만	SKILL.md 본문 전체
3단계: 부속 자료	필요할 때만	사실상 무제한	참고 문서, 실행 스크립트

매번 프롬프트에 규칙을 길게 다시 설명할 필요 없이, 한 번 정의해둔 작업 방식을 계속 재사용할 수 있는 구조입니다. 이 기능은 클로드 웹(claude.ai), 클로드 API, 클로드 코드(Claude Code)는 물론 AWS·Microsoft Foundry 같은 기업용 플랫폼에서도 동일한 방식으로 쓸 수 있습니다. Anthropic은 문서 작업을 위한 기본 제공 스킬로 워드(docx), 엑셀(xlsx), 파워포인트(pptx), PDF 스킬을 미리 만들어 두었고, 필요하면 사용자가 직접 스킬을 만들어 추가할 수도 있습니다.

요금제와 비용은 어떻게 되나

2026년 7월 기준 클로드 개인 요금제는 Pro(월 20달러 또는 연간 결제 시 상당한 할인), Max(월 100달러·평소 대비 5배 사용량 또는 월 200달러·20배 사용량) 등이 있습니다. Agent Skills와 플러그인 자체에는 추가 요금이 없으며, 이미 가입한 플랜의 사용량 한도 안에서 그대로 실행됩니다. 즉 Pro 요금제를 쓰고 있다면 별도 결제 없이 바로 Skills 기능을 켜서 써볼 수 있습니다.

SKILL.md 구조 실제로 뜯어보기

Agent Skills의 실체는 거창한 프로그램이 아니라 ‘SKILL.md’라는 마크다운 파일 하나입니다. 이 파일은 반드시 아래처럼 YAML 형식의 머리말(frontmatter)로 시작해야 합니다.

---
name: weekly-report-format
description: 팀 주간보고 양식으로 문서를 작성할 때 사용. 사용자가 \"주간보고\"나 \"위클리 리포트\"를 언급하면 이 스킬을 사용할 것.
---

# 주간보고 작성 가이드

## 지침
1. 제목은 \"YYYY년 W주차 팀 주간보고\" 형식으로 쓴다.
2. 섹션은 \"이번 주 성과 / 다음 주 계획 / 이슈 및 요청사항\" 순서로 고정한다.
3. 성과 항목은 숫자(완료 건수, 처리 시간 등)를 반드시 포함한다.

Anthropic 공식 문서는 name 필드에 소문자·숫자·하이픈만 쓸 수 있고 64자를 넘을 수 없으며, ‘anthropic’·’claude’ 같은 예약어는 쓸 수 없다고 명시합니다. description 필드는 최대 1,024자이며, “무엇을 하는 스킬인지”와 “언제 써야 하는지”를 함께 적어야 클로드가 정확한 순간에 해당 스킬을 호출합니다. 실전에서는 SKILL.md 하나로 끝나지 않고 아래처럼 부속 파일을 함께 묶는 경우가 많습니다.

weekly-report-skill/
├── SKILL.md          (핵심 지침, 항상 요약만 먼저 노출)
├── REFERENCE.md      (상세 서식 규칙, 필요할 때만 로드)
└── scripts/
    └── validate.py   (형식 검증 스크립트, 실행 결과만 컨텍스트에 남음)

이 구조가 중요한 이유는 ‘토큰 비용’ 때문입니다. 클로드는 평소에는 각 스킬의 이름·설명만 시스템 프롬프트에 올려두고, 실제로 관련 요청이 들어와 스킬이 트리거되면 그때 SKILL.md 본문을 불러오며, REFERENCE.md 같은 부속 파일이나 스크립트는 정말 필요한 순간에만 추가로 읽습니다.

스크립트는 코드 자체가 아니라 실행 결과만 컨텍스트에 남기 때문에, 부속 자료가 아무리 많아도 쓰지 않는 부분은 토큰을 전혀 소모하지 않습니다. 덕분에 하나의 스킬 폴더 안에 방대한 참고자료를 넣어둬도 평소 대화 성능에는 부담을 주지 않습니다.

시작 전 준비물

• 클로드 계정 (claude.ai 로그인)
• Pro 이상 유료 요금제 (코드 실행·파일 생성 기능을 안정적으로 쓰려면 권장)
• PC 웹 브라우저 (설정 화면은 데스크톱 환경에서 조작하는 편이 편리합니다)

클로드 Agent Skills 켜는 법

STEP 1. Settings > Capabilities로 이동

claude.ai에 로그인한 뒤 화면 좌측 하단(또는 우측 상단)의 프로필 아이콘을 클릭하면 나오는 메뉴에서 ‘Settings’를 선택합니다. Settings 화면 상단의 여러 탭 중 ‘Capabilities’를 클릭하면 코드 실행, 파일 생성, 스킬 관련 옵션이 모여 있는 화면이 나타납니다. 이 메뉴 구성은 PC 웹 브라우저 기준이며, 모바일 앱에서는 탭 배치가 다르게 보일 수 있어 처음 설정할 때는 데스크톱에서 진행하는 편이 헷갈리지 않습니다.

STEP 2. ‘코드 실행 및 파일 생성’ 기능 켜기

Capabilities 화면을 아래로 조금 내리면 ‘Code execution and file creation(코드 실행 및 파일 생성)’ 항목과 토글 스위치가 보입니다.

토글을 켜면 색이 바뀌며 활성화 상태로 표시되고, 이 상태여야 이후 Skills 탭의 개별 토글도 실제로 작동합니다. 흔한 실수는 이 상위 토글을 켜지 않은 채 Customize의 개별 스킬 토글만 켜두고 ‘왜 작동하지 않지’라며 헤매는 경우인데, Skills는 이 코드 실행 기능 위에서 돌아가는 구조라 순서를 바꿀 수 없습니다.

STEP 3. Customize > Skills에서 원하는 스킬 켜기

이어서 Customize 메뉴의 Skills 탭으로 이동하면 워드·엑셀·파워포인트·PDF 등 Anthropic이 기본 제공하는 스킬 목록이 카드 형태로 나열됩니다. 카드마다 오른쪽에 켜고 끄는 토글이 붙어 있어 필요한 스킬만 개별적으로 켤 수 있습니다. 처음이라면 당장 쓸 스킬 한두 개만 켜두는 편이 나중에 목록에서 원하는 스킬을 찾기 편합니다.

예를 들어 엑셀 스킬을 켜두면 기존 수식을 그대로 유지한 채로 스프레드시트를 수정하거나 새 계산식을 추가하는 작업을 맡길 수 있습니다. 반대로 이 스킬이 꺼진 상태에서 엑셀 파일을 첨부하면 클로드가 파일 내용을 단순 텍스트로만 읽어 수식이 깨지거나 서식이 사라지는 경우가 흔하니, 파일 형식을 그대로 유지하고 싶다면 관련 스킬이 켜져 있는지부터 확인해야 합니다.

STEP 4. (선택) 나만의 커스텀 스킬 만들기

기본 제공 스킬 외에, 팀의 보고서 양식이나 특정 업무 절차처럼 반복되는 작업 방식을 SKILL.md로 직접 정의할 수도 있습니다. claude.ai에서는 Settings > Features에서 zip 파일 형태로 업로드하며, 이 메뉴는 Pro·Max·Team·Enterprise 요금제에서 코드 실행 기능이 켜져 있어야 나타납니다. 흔한 실수는 SKILL.md 파일 하나만 딱 압축하는 것인데, zip 안에서 폴더 구조가 최상위 없이 파일만 흩어져 있거나 반대로 폴더가 여러 겹 중첩되면 업로드는 되어도 스킬로 인식되지 않는 경우가 있어 폴더 구조를 그대로 유지한 채 압축해야 합니다.

클로드 코드에서는 별도의 업로드 과정 없이 ~/.claude/skills/(개인용) 또는 프로젝트 폴더의 .claude/skills/ 아래에 스킬 폴더를 만들어두기만 하면 클로드가 자동으로 인식합니다. 다만 claude.ai에 올린 스킬과 API·클로드 코드의 스킬은 서로 동기화되지 않는 별도 시스템이라, 두 환경 모두에서 같은 스킬을 쓰려면 각 환경에 따로 등록해야 합니다.

실전 활용 아이디어: 블로그 운영과 부업에 적용한다면

Agent Skills의 진짜 강점은 ‘매번 반복되지만 프롬프트로 다시 설명하기엔 번거로운 규칙’을 폴더 하나에 고정해두는 데 있습니다. 이 블로그처럼 콘텐츠를 꾸준히 만들거나 프리랜서로 여러 클라이언트를 상대하는 상황에서는 다음과 같은 각도로 응용해볼 수 있습니다.

• 블로그 원고 스타일 가이드 스킬화: “TL;DR은 맨 위에 배치, 문단은 3문장 이내, FAQ는 4개, 이미지 마커는 IMG_1·IMG_2 형식으로 순번 표기” 같은 이 블로그만의 작성 규칙을 SKILL.md 하나에 정리해두면, 새 글을 쓸 때마다 규칙을 다시 설명하지 않아도 같은 틀의 초안을 받을 수 있습니다. description에 “블로그 글 초안을 쓸 때 사용”처럼 트리거 조건을 명확히 적어두는 것이 핵심입니다.
• 프리랜서 클라이언트 보고서 양식 고정: 여러 클라이언트에게 매달 비슷한 형식의 결과 보고서(작업 내역, 다음 달 제안, 청구 내역)를 보내야 한다면, 워드·엑셀 스킬과 커스텀 SKILL.md를 함께 활용해 클라이언트가 바뀌어도 항상 같은 구조의 보고서를 뽑을 수 있습니다.
• 사이드 프로젝트 기획서 템플릿: 전자책, 온라인 강의, 스마트스토어처럼 부업으로 여러 사이드 프로젝트를 동시에 굴리는 경우, 기획서나 상세페이지 문구 초안을 “제목/타겟/차별점/가격” 같은 고정 섹션 순서로 뽑아주는 스킬을 만들어두면 프로젝트마다 기획서 형식이 들쭉날쭉해지는 것을 막을 수 있습니다.
• 레퍼런스 요약 루틴 고정: 콘텐츠 기획 참고용으로 여러 PDF 자료나 경쟁 블로그 글을 볼 때 “핵심 주장 3줄 + 인용 가능한 데이터 + 내 글에 적용할 각도” 순서로 요약하는 스킬을 만들어두면, 자료마다 요약 형식이 달라 서로 비교하기 어려운 문제를 줄일 수 있습니다.

이 스킬들의 공통점은 모두 ‘형식은 고정, 내용만 매번 다른’ 반복 작업이라는 점입니다. Agent Skills는 이런 유형의 반복에 강하지만, 매번 새로운 판단이 필요한 창작성 짙은 작업이라면 스킬을 만드는 수고에 비해 얻는 이득이 크지 않을 수 있습니다.

이전에 다룬 챗GPT 에이전트 모드 사용법이 웹사이트를 직접 돌아다니며 여러 단계 작업을 대신 수행하는 데 강점이 있다면, 클로드 Agent Skills는 문서 작업의 형식과 절차를 한 번 정의해두고 계속 같은 품질로 재사용하는 데 강점이 있습니다. 두 기능은 목적이 조금 달라 상황에 맞게 골라 쓰는 편이 낫습니다.

쓸 때 주의할 점

Skills는 지침뿐 아니라 실행 스크립트까지 포함할 수 있는 구조이므로, 출처가 불분명한 커스텀 스킬을 무분별하게 설치하는 것은 피하는 편이 안전합니다. Anthropic 공식 문서는 “본인이 직접 만들었거나 Anthropic에서 받은 스킬만 신뢰하라”고 권고하며, 특히 외부 URL에서 데이터를 가져오는 스킬은 가져온 내용에 악성 지침이 섞여 있을 위험이 있다고 경고합니다.

낯선 출처의 스킬을 꼭 써야 한다면 SKILL.md 본문뿐 아니라 스크립트·이미지 등 번들된 모든 파일을 직접 열어 예상 밖의 네트워크 호출이나 파일 접근 패턴이 있는지 점검해야 합니다. 기업 환경에서는 관리자가 조직 내 사용자들의 Skills 사용 범위를 별도로 통제할 수 있는 설정도 제공됩니다.

자주 묻는 질문

Agent Skills를 쓰면 추가 요금이 드나요?

아니요. Skills와 플러그인 자체에는 별도 요금이 없으며, 이미 가입한 Pro·Max·Team 요금제의 사용량 한도 안에서 추가 비용 없이 실행됩니다.

SKILL.md의 name 필드는 아무렇게나 지어도 되나요?

아니요. Anthropic 공식 문서에 따르면 name은 소문자·숫자·하이픈만 사용해 64자 이내로 지어야 하고 ‘anthropic’, ‘claude’ 같은 예약어는 쓸 수 없습니다. description은 최대 1,024자이며, 스킬이 ‘무엇을’ 하는지와 ‘언제’ 써야 하는지를 함께 적어야 클로드가 정확한 시점에 스킬을 인식합니다.

커스텀 스킬을 claude.ai와 클로드 코드에서 동시에 쓸 수 있나요?

아니요. claude.ai에 업로드한 스킬과 API·클로드 코드의 스킬은 서로 동기화되지 않는 별도 시스템입니다. claude.ai 커스텀 스킬은 개인 계정 단위로만 적용되고 조직 전체에 일괄 배포할 수 없으며, 여러 환경에서 쓰려면 각각 따로 등록해야 합니다.

Skills를 켜두면 항상 자동으로 실행되나요?

사용자가 관련 작업을 요청했을 때만 클로드가 해당 스킬의 전체 지침을 불러와 사용합니다. 평소에는 이름·설명 정도만 가볍게(스킬당 약 100토큰) 인식하고 있어 다른 대화 성능에 영향을 주지 않습니다.

핵심 요약

1. Agent Skills는 SKILL.md 파일에 지침을 담아 재사용하는 기능으로, name·description 필드 규칙을 지키면 메타데이터(약 100토큰)→본문(5,000토큰 미만)→부속자료 순으로 필요할 때만 불러옵니다.
2. 설정은 Settings > Capabilities에서 ‘코드 실행 및 파일 생성’을 켠 뒤 Customize > Skills에서 원하는 스킬을 켜는 순서로 진행하며, 추가 요금은 없습니다.
3. 블로그 원고 스타일, 프리랜서 보고서, 사이드 프로젝트 기획서처럼 ‘형식은 고정, 내용만 매번 다른’ 반복 작업을 표준화하는 데 강점이 있지만, 출처가 불분명한 커스텀 스킬은 실행 스크립트가 포함될 수 있어 설치 전 반드시 내용을 점검해야 합니다.

---