Anthropic Skills 만들기 완벽 가이드: 공식 레포 패턴 정리 (2026)

"Claude Code 잘 쓰는 법은 이미 다 봤는데, 내 워크플로에 맞게 직접 확장하는 법은 왜 안 보일까?"

📌 핵심 3줄 요약

• 2026년 5월 anthropics/skills 공식 레포가 공개되고 Adobe·Oracle·K-Dense가 줄줄이 자체 Skills 세트를 풀면서 "사용자에서 제작자로" 전환이 본격화됐다.
• Anthropic Skills 만들기의 핵심은 결국 폴더 하나 + SKILL.md 한 장이다. 트리거 키워드만 정확히 잡으면 30분 안에 첫 커스텀 Skill을 띄울 수 있다.
• MCP가 "외부 도구 연결"이라면 Skills는 "에이전트 행동 패턴 묶음"이다. 둘은 경쟁이 아니라 보완 관계이며, 작은 반복 작업일수록 Skills 쪽이 압도적으로 빠르다.

1. 갑자기 Skills가 트렌딩하는 이유

2026년 5월 둘째 주, GitHub 트렌딩 1면을 anthropics/skills가 차지했다. 공식 레포 공개 24시간 안에 Adobe·Oracle·K-Dense AI가 줄줄이 자체 Skills 세트를 풀면서 "Claude를 도구로 쓰는 시대"에서 "Claude 행동을 직접 설계하는 시대"로 분위기가 넘어갔다.

한국 개발자 입장에서 중요한 이유는 두 가지다. 커스텀 Skill 작성 한국어 자료가 거의 비어 있고, Skills는 MCP보다 진입장벽이 낮아 주말 한 번이면 사내 PR 리뷰 규칙·문서 양식·배포 체크리스트를 그대로 Skill로 옮길 수 있다.

2026년 5월 둘째 주 Skills 생태계 확장 흐름

2. Skills란 정확히 무엇인가 (MCP와의 차이)

Skills는 "Claude가 특정 상황에서 일관되게 따를 절차·지침·스크립트 묶음"이다. 폴더 하나에 SKILL.md와 보조 자료(references/, scripts/)를 넣어두면, 트리거 키워드 감지 시 Claude가 자동으로 그 폴더 지침을 따른다.

가장 자주 받는 질문 "MCP랑 뭐가 다르냐"는 다음 표 한 장이면 해결된다.

구분	Skills	MCP
목적	행동 패턴·절차 묶음	외부 시스템 도구 연결
구성 단위	폴더 + SKILL.md	서버 프로세스 + 프로토콜
진입 난이도	낮음 (30분)	중간 (서버 코드 필요)
실행 주체	Claude 자체	외부 MCP 서버
적합한 작업	반복 가이드·코드 패턴	DB·API·외부 SaaS 연동

"사내 PR 리뷰 체크리스트"는 Skills, "Jira 티켓 직접 조회"는 MCP가 맞다. 둘은 같이 쓰는 게 자연스럽다.

3. 공식 레포 폴더 구조 해부

anthropics/skills를 처음 클론하면 폴더 트리부터 눈에 들어온다. 패턴이 명확해 한 번 보면 자기 Skill에 그대로 베껴 쓸 수 있다.

skills/
├── document-skills/
│   ├── pdf-extractor/
│   │   ├── SKILL.md          # 매니페스트 (필수)
│   │   ├── references/       # 참고 자료·예제
│   │   │   └── examples.md
│   │   └── scripts/          # 실행 스크립트 (선택)
│   │       └── extract.py
│   └── markdown-summarizer/
│       └── SKILL.md
├── code-skills/
│   └── pr-review/
│       ├── SKILL.md
│       └── references/
│           └── checklist.md
└── README.md

핵심 규칙은 셋이다. SKILL.md는 폴더당 정확히 한 장, 보조 자료는 references/에 넣고 경로로 참조, 결정론적 실행이 필요한 작업(파일 변환·정규식 처리)은 scripts/에 두고 LLM이 호출. 이 패턴만 지키면 Claude Code가 별도 설정 없이 인식한다.

공식 레포 권장 폴더 패턴 한눈에

4. SKILL.md 작성 규칙과 트리거 키워드

SKILL.md는 frontmatter(YAML 헤더) + 본문 구조다. frontmatter는 자동 호출 판단 기준, 본문은 실제 행동 지침. 공식 레포 기준 최소 구성은 다음과 같다.

---
name: pr-review-korean
description: 한국어 PR 본문을 Anthropic 사내 스타일 가이드에 맞춰 리뷰하는 절차
triggers:
  - "PR 리뷰해줘"
  - "코드 리뷰 부탁"
  - "review this pull request"
---

# 한국어 PR 리뷰 Skill

## 입력
- diff 텍스트 또는 PR URL

## 절차
1. diff에서 변경 파일 목록 추출
2. references/checklist.md 항목별로 검토
3. 한국어 + 영어 키워드 혼용 시 용어 통일 제안
4. 최종 리뷰는 마크다운 5섹션으로 출력

## 출력
- summary, must-fix, suggestions, questions, lgtm

핵심 필드는 description과 triggers다. Claude는 사용자 메시지를 받으면 등록된 모든 Skill의 description을 훑어보고, 트리거 매칭 또는 description 의미 일치 시 해당 Skill을 활성화한다. description은 "PR 리뷰" 같은 일반 명사 대신 "한국어 PR 본문을 사내 스타일 가이드로 리뷰"처럼 조건을 좁게 써야 한다.

💡 트리거 작성 팁

• 실제 자신이 평소 쓰는 문장 그대로 넣을 것 ("리뷰해줘", "정리 좀")
• 한국어·영어 둘 다 등록하면 코드 작업 중 영어 명령에도 잡힌다
• 너무 일반적인 트리거("도와줘")는 다른 Skill과 충돌하므로 피한다

5. 30분 안에 첫 Skill 만들기 — 마크다운 요약 예제

가장 작은 예제로 손에 익혀보자. 마크다운을 3줄 요약으로 압축하는 Skill이다. 폴더 하나, SKILL.md 한 장, references 하나면 끝.

1단계: 폴더 생성.

mkdir -p ~/.claude/skills/markdown-3line-summary/references
cd ~/.claude/skills/markdown-3line-summary

2단계: SKILL.md 작성.

---
name: markdown-3line-summary
description: 긴 마크다운 문서를 한국어 3줄 요약으로 압축
triggers:
  - "3줄 요약"
  - "마크다운 요약해줘"
  - "summarize markdown"
---

# 마크다운 3줄 요약 Skill

## 절차
1. 입력 문서에서 H1~H2 제목과 첫 단락만 추출
2. references/style.md 규칙 적용 (문장당 40자 이내)
3. 출력 형식:
   - 한 줄: 핵심 결론
   - 두 줄: 핵심 근거
   - 세 줄: 다음 행동 제안

3단계: references/style.md에 스타일 규칙을 한 페이지로 정리. 4단계: Claude Code 재시작 후 "이 README 3줄 요약해줘"라고 입력하면 새 Skill이 자동 호출된다. 안 잡히면 /skills 명령으로 등록 여부부터 확인.

최소 구성 Skill 만들기 4단계

6. Adobe·Oracle·K-Dense 사례에서 배우는 패턴

3사 Skills를 뜯어보면 강조점이 다르다. 자기 도메인에 맞는 걸 골라 쓰면 된다.

• Adobe — scripts/에 Python 변환기를 두고, SKILL.md는 "어느 상황에서 어떤 스크립트를 부를지" 분기 가이드 역할만. 결정론과 LLM 판단의 경계가 명확.
• Oracle — DB 스키마 관리 Skills의 references/에 회사 표준 명명 규칙·인덱스 가이드를 SQL 예제와 함께 수록. 사내 규정을 Skill로 그대로 옮긴 케이스.
• K-Dense AI — 트리거를 도메인 용어("RNA-seq 분석", "western blot")로 좁혀 일반 코딩 질문과 충돌을 차단했다.

공통점은 "한 Skill에 모든 걸 넣지 않는다"는 것. PDF 추출과 요약은 별도 Skill로 쪼개고 Claude가 순차 호출. 이래야 유지보수가 쉽다.

⚠️ 단점과 주의할 점

• 스펙이 빠르게 바뀐다 — 2026-05 기준 frontmatter 필드는 triggers지만 activation·scope 추가가 예고됐다. 운영 적용 전 공식 README 재확인 필수.
• 트리거 충돌 디버깅이 어렵다 — Skill 5개 이상이면 어느 게 잡혔는지 헷갈린다. 트리거는 의도적으로 길고 구체적으로.
• 민감 정보 노출 위험 — references에 사내 PDF 넣고 GitHub 푸시하는 사고가 보고됨. private references는 .gitignore로 분리.
• 스크립트 권한 — scripts/는 Claude Code 권한 모델을 따른다. 매 실행마다 승인 프롬프트가 뜬다.

7. 자주 묻는 질문

• Q. 자동으로 호출되나? — 트리거 또는 description 의미가 일치하면 자동. 강제는 /skills run <name>.
• Q. 팀 공유는? — Skill 폴더를 git 레포로 두고 팀원이 ~/.claude/skills/에 clone. 별도 패키징 없음.
• Q. scripts·references 없어도 되나? — 된다. 단순 가이드면 SKILL.md 한 장으로 충분.
• Q. Claude Desktop에서도? — 2026-05 기준 Claude Code 우선 지원, Desktop은 베타.
• Q. MCP와 같이 쓸 수 있나? — 가능. Skill 본문에서 MCP 도구를 명시 호출하는 게 권장 패턴.

참고 자료

• anthropics/skills 공식 레포
• Adobe Skills 공개 세트
• Oracle Skills 공개 세트
• K-Dense AI Scientific Agent Skills
• Claude Code 공식 문서

🚀 지금 바로 할 일

1. anthropics/skills 레포를 클론하고 document-skills/ 한 폴더만 골라 SKILL.md 구조를 5분간 읽기.
2. ~/.claude/skills/에 자기만의 폴더 1개 만들고 본문 5장 예제(마크다운 3줄 요약)를 그대로 복사해 첫 Skill 띄우기.
3. 일주일간 자기가 Claude에게 가장 자주 시키는 작업 1~2개를 골라 그것만 Skill로 옮겨보기 — 새 Skill을 5개씩 만들지 말 것.

💬 의견

이미 사내에서 Skills를 시험 중이라면 어떤 작업이 가장 효과가 좋았는지 댓글로 알려주세요. 다음 글에서는 Skill에 MCP 서버를 결합해 사내 Jira·Confluence까지 다루는 패턴을 정리할 예정입니다.

---

작성자: AI 도구 트렌드 분석가. 2024년부터 Anthropic·OpenAI의 코딩 에이전트를 한국 개발 환경에 맞춰 검증해 왔습니다. 본 글은 2026년 5월 17일 시점의 anthropics/skills 공식 레포와 Adobe·Oracle·K-Dense 공개 세트를 1차 출처로 정리했으며, 스펙은 변경될 수 있어 운영 적용 전 공식 문서 재확인을 권장합니다.