앤트로픽 팀의 Claude Code Skills 입문: 반복 업무를 AI에게 맡기는 법 (입문편)

이런 분을 위한 글입니다

Claude Code를 쓰기 시작했거나, 써볼까 고민 중인 분

읽고 나면 이렇게 달라집니다

프롬프트만 쓰던 단계에서 벗어나, 반복 업무를 스킬로 맡길 준비가 됩니다

매번 같은 설명을 반복하고 있다면

AI에게 일을 시킬 때마다 같은 설명을 반복하고 있나요?

예를 들면 이런 말들입니다.

“지난번처럼 정리해줘.”
“빠진 항목 없는지 확인해줘.”
“우리 기준에 맞게 다시 다듬어줘.”

한두 번은 괜찮습니다. 그런데 같은 일을 계속 맡긴다고 생각하면 금방 귀찮아집니다. 매번 기준을 다시 설명해야 하고, 확인할 항목도 다시 말해야 합니다. 지난번에는 잘하던 일을 이번에는 빼먹기도 합니다.

블로그 작성도 그렇습니다. 출처 표시, 제목 후보, SEO 메타 설명, 발행 체크리스트처럼 매번 반복해서 챙겨야 하는 기준이 많습니다.

이럴 때 필요한 게 스킬(Skill)입니다.

Claude Code는 Anthropic의 AI 코딩 도구입니다. 그리고 여기서 말하는 스킬은 Claude Code가 특정 일을 반복해서 잘 처리하도록 만든 작업 폴더에 가깝습니다.

Anthropic은 Claude Code를 만들면서 내부적으로 수백 개의 스킬을 운영했다고 합니다. 그 경험을 정리한 글이 Lessons from building Claude Code: How we use skills입니다.

이 시리즈는 그 글에 담긴 운영 경험을, 개발자가 아닌 사람도 자기 업무에 바로 적용할 수 있게 풀어 갑니다. 이름에는 Code가 들어가지만, 여기서 중요한 건 코딩 실력이 아닙니다. 반복되는 글쓰기, 검수, 정리 업무를 AI에게 일관되게 맡기는 방법을 배우는 것이 핵심입니다.

블로그가 아니어도 같습니다. 회의록 정리, 고객 문의 답변 초안, 강의 자료 검수, 주간 보고서 작성처럼 매번 비슷한 기준으로 하는 일이라면 스킬 후보가 될 수 있습니다.

이번 1편에서는 스킬이라는 개념부터 잡습니다.

스킬은 그냥 메모장이 아닙니다

처음에는 스킬을 이렇게 생각하기 쉽습니다.

“그냥 지시문 적어둔 마크다운 파일 아닌가?”

그런데 Claude Code 팀이 말하는 스킬은 조금 더 큽니다. 단순한 지시문 하나가 아니라, 반복 업무에 필요한 자료 묶음에 가깝습니다.

영어 이름을 외울 필요는 없습니다. 세 가지로 나누면 지시, 자동화 코드, 참고자료입니다.

구성 요소	쉽게 말하면	예시
instructions	일을 어떤 순서와 기준으로 할지 적어둔 설명	“블로그는 도입부, 핵심 설명, 실무 적용 순서로 쓴다.”
scripts	반복 작업을 대신 처리하는 코드	파일 정리, 링크 확인, 메타데이터 생성
resources	작업할 때 참고할 자료	브랜드 톤, 예시 글, 체크리스트

처음 스킬을 만들 때 scripts까지 준비할 필요는 없습니다. 코딩을 전혀 몰라도 instructions와 resources만으로 시작할 수 있습니다. 링크 확인처럼 매번 반복되는 검사가 생겼을 때 나중에 scripts를 붙이면 됩니다.

프롬프트와 스킬의 차이는 이렇게 보면 쉽습니다.

구분	쉽게 말하면	예시
프롬프트	AI에게 그때그때 말로 부탁하는 것	“이 글을 블로그용으로 정리해줘.”
스킬	자주 하는 일을 미리 정리해둔 업무 매뉴얼	“블로그 글은 이 순서, 이 톤, 이 체크리스트대로 작성해.”

비유하면

프롬프트는 아르바이트생에게 매번 말로 설명하는 것에 가깝습니다. 스킬은 그 아르바이트생에게 업무 매뉴얼을 만들어주는 것에 가깝습니다.

말로 한 번 설명하면 그 순간에는 움직입니다. 하지만 다음번에 또 설명해야 합니다. 반대로 매뉴얼이 있으면 같은 일을 할 때마다 기준을 다시 꺼내 쓸 수 있습니다.

스킬은 보통 두 가지 방식으로 쓰입니다. 하나는 Claude가 요청을 보고 “이 스킬이 필요하겠다”고 자동으로 불러오는 방식입니다. 다른 하나는 사용자가 /blog-writing처럼 직접 부르는 방식입니다. 초보자는 일단 “AI가 필요할 때 꺼내 읽는 업무 매뉴얼” 정도로 이해하면 충분합니다.

공식 문서는 스킬을 만들 신호도 현실적으로 설명합니다. 같은 지시문, 체크리스트, 여러 단계 절차를 계속 붙여넣고 있다면 스킬 후보입니다. 단순한 배경지식은 CLAUDE.md 같은 기본 안내에 둘 수 있지만, “먼저 이것을 확인하고, 그다음 이 파일을 보고, 마지막에 이 형식으로 결과를 내라”처럼 절차가 길어지면 스킬로 분리하는 편이 낫습니다.

스킬이 없으면 뭐가 불편할까?

블로그 작성 업무를 예로 들어보겠습니다.

스킬이 없다면 매번 이런 지시를 해야 합니다.

Claude Code 팀의 스킬 운영 사례를 한국 독자가 이해하기 쉬운 블로그 글로 풀어줘.
단순 번역처럼 보이면 안 되고, 왜 AI 업무 매뉴얼이 필요한지 먼저 느껴지게 써줘.
Claude Code 팀이 말한 내용과 내 해설이 섞여 보이지 않게 출처를 자연스럽게 표시해줘.
제목 후보 3개, SEO 메타 설명, 태그도 같이 만들어줘.
마지막에는 발행 전에 확인할 체크리스트까지 정리해줘.

문제는 이걸 매번 똑같이 말하기가 어렵다는 겁니다.

오늘은 “출처를 자연스럽게 표시해줘”라고 말했는데, 내일은 그 말을 빼먹을 수 있습니다. 오늘은 “SEO 메타 설명도 만들어줘”라고 했는데, 다음번에는 제목 후보만 받고 끝날 수도 있습니다.

AI도 매번 같은 방식으로 이해하지 않습니다. 그래서 결과물이 흔들립니다.

어떤 글은 출처가 자연스럽게 들어갑니다.
어떤 글은 단순 요약문처럼 끝납니다.
어떤 글은 제목은 괜찮은데 SEO 정보가 빠집니다.
어떤 글은 발행 체크리스트가 없습니다.

문제의 핵심

“AI가 일을 못 한다”가 문제가 아닙니다. 반복 업무의 기준을 매번 말로 다시 전달해야 하는 것이 문제입니다.

스킬은 이 불편함을 줄이기 위한 장치입니다. 자주 반복되는 일의 작업 방식을 한 번 정리해두고, 필요할 때 AI가 그 내용을 읽고 일하게 만드는 겁니다.

정리하면

Claude Code Skills는 AI에게 매번 같은 설명을 반복하지 않기 위한 작업 매뉴얼입니다.

프롬프트는 이번 한 번의 지시입니다. 스킬은 반복되는 업무 방식을 저장해두는 장치입니다.

구분	역할
프롬프트	이번 한 번의 지시
스킬	반복되는 업무 방식

AI에게 계속 같은 기준을 다시 말하고 있다면, 그건 스킬로 만들 업무를 찾았다는 신호입니다.

오늘은 딱 하나만 해보면 됩니다. 최근 AI에게 3번 이상 비슷하게 시킨 일을 하나 적어보세요. 그리고 아래 질문에 답해보세요.

내가 AI에게 자주 시키는 일: ____________________
매번 반복해서 설명하는 기준: ____________________
AI가 자주 빼먹는 것: ____________________
결과물에 꼭 들어가야 하는 것: ____________________

여기까지 적었다면, 이미 첫 스킬 후보를 찾은 겁니다.

다음 편

2편 · Claude Code Skills 잘 만드는 법 (설계편)

좋은 스킬의 조건을 다룹니다. 스킬 이름과 description을 정하는 기준, 자주 하는 실수(gotchas)를 적는 법을 예시로 봅니다.