클로드 코드 스킬 1편: 입문 — 반복 업무를 AI 매뉴얼로 만드는 법

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

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

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

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

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

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

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

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

다만 이 글은 원문을 그대로 옮긴 번역문이 아닙니다. Claude Code 팀의 스킬 운영 경험을 바탕으로, 개발자가 아닌 초보자도 이해할 수 있게 풀어본 1편 입문 해설입니다.

이 글에서 가져갈 것

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

정리하면

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

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

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