agent-skills인 Claude Skills는 반복 업무의 지침을 한 번 정의해 두면 Claude가 맥락을 인식하고 자동으로 실행하는 재사용 가능한 워크플로 패키지다. 프롬프트를 매번 다시 쓰거나 붙여넣는 대신, 작업 요청만 하면 저장된 플레이북이 자동으로 구동된다. 이 글은 Ahrefs 콘텐츠 마케터의 실제 경험을 바탕으로, SEO와 마케팅 담당자가 Claude Skills를 어떻게 만들고 활용하는지 단계별로 정리한다. geo 및 검색 최적화 워크플로에도 직접 응용할 수 있다.

Claude Skills란 무엇인가

프롬프트는 일회성 지시다. 입력하고 응답을 받으면 지시는 사라진다. 다음에 같은 작업을 하려면 다시 입력해야 한다.

스킬(Skill)은 다음 단계다. 플레이북을 한 번 작성하면 Claude가 요청 내용을 읽고 어떤 스킬을 적용할지 스스로 판단해 실행한다. 메뉴도 없고 붙여넣기도 없다. 작업을 자연스러운 말로 설명하기만 하면 저장된 플레이북이 작동한다.

스킬의 포맷은 오픈 스탠다드다. Anthropic은 이를 Agent Skills라 부르며, Claude Code에 내장된 스킬들도 동일한 SKILL.md 형식을 사용한다.

스킬의 구조

스킬은 하나의 폴더다. 그 안에 SKILL.md 파일이 있고, YAML 프런트매터와 플레이북으로 구성된다.

name: linkedin-pipeline
description: Pull an article URL and generate 3–5 distinct LinkedIn posts.
  Use whenever the user wants to turn an article into LinkedIn content.

## Instructions

1. Fetch the article at $ARGUMENTS.
2. Identify 3–5 distinct angles (insight, statistic, narrative, contrarian, question).
3. Write one LinkedIn post per angle.
4. Apply voice rules: conversational, no buzzwords, fold-line hook, no em dashes.
5. End each post with a soft CTA.

3단계 점진적 공개(Progressive Disclosure)

스킬은 토큰 비용을 아끼기 위해 3단계로 정보를 공개한다.

1. 프런트매터(항상 컨텍스트에 있음) — 이름과 설명. Claude가 스킬을 발동할지 판단하는 근거.
2. SKILL.md 본문(스킬이 실행될 때 로드) — 실제 플레이북.
3. 연결된 파일(플레이북이 호출할 때만 로드) — 긴 스타일 가이드, 예시 라이브러리 등.

스킬 폴더 위치:

• 프로젝트 전용: .claude/skills/<skill-name>/SKILL.md
• 전역(모든 프로젝트): ~/.claude/skills/<skill-name>/SKILL.md

실제로 잘 작동하는 스킬 만드는 법

1. 반복하는 작업 하나를 고른다

한 번에 모든 것을 스킬화하려 하면 오후가 통째로 날아간다. 두 가지 기준을 모두 충족하는 작업을 하나 고른다.

• 정기적으로 수행하는 작업
• 매번 같은 맥락을 다시 설명해야 하는 작업

SEO·마케팅에서 흔한 후보:

• 발행된 아티클을 LinkedIn 포스트로 변환
• 인터뷰 트랜스크립트에서 인용구 추출
• 콘텐츠 브리프를 특정 톤으로 재작성
• 아티클 초안을 편집 체크리스트로 QA

“좋은 결과물이 어떻게 생겼는지 한 문장으로 말할 수 없다면” 스킬을 만들 준비가 안 된 것이다. 먼저 채팅으로 충분히 연습해 기준을 명확히 한 뒤 스킬화한다.

2. 설명(description)을 실제 트리거로 작성한다

설명은 Claude가 스킬을 발동할지 판단하는 유일한 기준이다. 세 가지 역할을 동시에 해야 한다.

트리거 표현은 기능 설명 방식이 아닌 자신이 실제로 말하는 방식으로 쓴다.

발동되지 않는 예: “Helps with writing” — 너무 광범위해서 매칭이 안 된다. 발동되는 예: “Use when the user asks for a summary, recap, or TL;DR of an article” — 구체적인 태스크와 트리거 표현이 명확하다.

3. 보여주는 방식으로 작성한다

스킬 본문에서 가장 많이 실패하는 지점은 “내 목소리를 맞춰줘” 같은 추상적 지시다.

효과적인 방법 4가지:

• 실제 예시(worked examples): 실제 입력과 원하는 출력을 나란히 붙인다. 설명 한 단락보다 좋은 예시 하나가 낫다.
• 명시적 금지 사항: “em dash 사용 금지”, “정의로 시작 금지”, “섹션 3개 초과 금지”처럼 이미 겪은 실패를 규칙으로 정의한다.
• 자가 점검 체크리스트: 응답하기 전 Claude가 실행할 짧은 체크리스트를 추가하면 지시문 드리프트를 줄인다.
• 간결함: 스킬이 길고 복잡할수록 Claude가 전부 따를 가능성이 낮아진다. Anthropic은 SKILL.md를 500줄 이내로 권장한다.

4. 긴 콘텐츠는 별도 파일로 분리한다

긴 스타일 레퍼런스, 예시 라이브러리, 경쟁사 URL 목록, API 문서는 스킬 폴더 내 별도 파일로 저장한다. SKILL.md에서 참조하되 붙여넣지 않는다. 플레이북이 해당 파일을 호출할 때만 로드되므로 기본 토큰 비용은 0이다.

5. 부작용이 있는 스킬은 잠금 설정한다

실수로 발동되면 안 되는 스킬(배포, CMS 발행, Slack 메시지 전송 등)은 프런트매터에 disable-model-invocation: true를 추가한다. 명시적으로 /skill-name 형태로 호출해야만 실행된다.

name: publish-to-cms
description: Publish the current draft to WordPress via the CMS API.
disable-model-invocation: true

SEO·마케팅에서 활용 예시

Ahrefs 콘텐츠 마케터 Si Quan Ong은 새 아티클 URL을 Claude에 넣고 /linkedin-pipeline을 실행하는 것만으로 3~5개의 LinkedIn 포스트를 생성한다. 이전에는 매번 목소리 규칙, 훅 패턴, CTA 스타일을 다시 설명해야 했다.

Ahrefs의 콘텐츠 디렉터 Ryan Law는 23개 스킬로 구성된 콘텐츠 엔지니어링 파이프라인을 구축했다. 메인 blog-pipeline 스킬 뒤에 스킬들이 체인으로 연결돼 6~12분 만에 발행 준비가 된 아티클을 생성한다.

주목할 점은 “스킬 파일 작성” 자체는 쉬운 부분이라는 것이다. 어려운 부분은 13년간 쌓인 편집 경험을 명시적 규칙으로 풀어내는 일이다.

SEO·마케팅 맥락에서 바로 시작할 수 있는 스킬 아이디어:

• content-gap — Ahrefs 데이터로 콘텐츠 갭 분석
• brand-sentiment — AI 브랜드 감성 분석
• traffic-decline — 트래픽 하락 콘텐츠 탐지
• linkbait-ideas — 링크베이트 기회 발굴

스킬을 만드는 가장 빠른 방법

Anthropic이 공개한 skill-creator 스킬을 활용하면 새 스킬 생성 과정을 Claude가 안내해 준다. 공개 스킬 저장소에서 fork하거나 복사해 바로 사용할 수 있다.

Claude Code에는 기본 제공 스킬도 있다: /batch, /claude-api, /debug, /loop, /simplify.

마치며

스킬은 Claude를 “매번 설명을 반복해야 하는 채팅 창”에서 “훈련시킬 수 있는 시스템”으로 바꾼다. 작은 것부터 시작하자. 매주 화요일에 하는 작업, 어떻게 하는지 딱 떠오르지 않는 그 작업. skill-creator로 15분 만에 초안을 만들고, 다음 번에 그 작업이 돌아왔을 때 제대로 작동하는지 확인하면 된다. 한 번 성공하면 계속 스킬을 만들게 된다.

참고 자료

• Claude Skills for SEO and Marketing — Ahrefs Blog (2026-05-10)
• anthropics/skills — GitHub 공식 저장소