클로드 코드에서 잘 쓰던 스킬을 챗GPT나 커서에서도 쓰고 싶다면, 그 스킬이 공개 표준에 맞는지부터 보면 됩니다. 10월 22일 앤트로픽은 스킬 형식인 에이전트 스킬(Agent Skills) 표준을 리눅스 재단 아래 에이전틱 AI 재단(AAIF)에 넘겼습니다. 발표 내용을 정리하고, 표준 공식 검사기로 이 맥의 스킬을 검사한 뒤 걸린 스킬은 클로드 코드에게 고치게 해 봤습니다.
- 무슨 일: 클로드 스킬 표준(SKILL.md 형식)의 주인이 앤트로픽에서 리눅스 재단 프로젝트로 바뀌었습니다. 구글·오픈AI 엔지니어도 함께 관리합니다.
- 누구에게: 스킬을 직접 만들거나 받아 쓰는 사람입니다. 표준을 지키면 챗GPT·코덱스·커서·깃허브 코파일럿 같은 다른 도구에서도 같은 스킬을 읽습니다.
- 지금 할 일: 공식 검사기로 내 스킬을 1분이면 검사할 수 있습니다. 이 맥의 플러그인 속 스킬은 285개가 걸렸고, 절반이 넘게는 argument-hint·user-invocable 같은 클로드 코드 전용 칸 때문이었습니다.
결과부터 보기: 내 스킬은 표준에 맞을까
일부러 표준에 안 맞게 만든 연습용 스킬 하나와, 이 맥에 깔린 스킬 전체를 공식 검사기로 검사했습니다. 걸린 스킬은 클로드 코드에게 표준에 맞게 고쳐 달라고 했습니다.
직접 눌러 보기: 스킬 표준 검사기. SKILL.md 내용과 폴더 이름을 붙여 넣으면 표준 규칙에 걸리는 곳을 짚고, 표준에 맞춘 머리말 예시를 보여 줍니다. 넣은 내용은 화면 안에서만 검사합니다.

직접 실행 확인한 날짜 2026-10-23
- 실행 환경
- macOS 26.1 · 공식 검사기 skills-ref 0.1.0(작업 폴더 안 파이썬 가상환경) · 클로드 코드 2.1.299
- 모델·생각 깊이
- 클로드 코드 Sonnet 5.5 · 생각 깊이 중간
- 비용
- 표준·검사기 무료. 클로드 코드로 고치기 한 번에 API 요금으로 0.13달러 안팎
- 라이선스
- agentskills 저장소 Apache-2.0
앤트로픽이 넘긴 것, 바뀌는 것
스킬은 SKILL.md 파일 하나를 중심으로 지시문과 스크립트, 참고 자료를 묶은 폴더입니다. 클로드가 이 폴더를 읽고 정해진 순서대로 일합니다. 처음이라면 클로드 스킬이란 글부터 보면 됩니다.
앤트로픽 발표 기준으로 정리하면 이렇습니다.
| 무엇이 | 내용 |
|---|---|
| 넘긴 것 | 표준 이름과 로고, 깃허브 조직(agentskills), 명세 사이트 agentskills.io |
| 받은 곳 | 에이전틱 AI 재단(AAIF). 리눅스 재단 프로젝트로, 앤트로픽이 2025년 블록·오픈AI와 함께 세웠고 MCP도 이미 이곳에 넘겼습니다 |
| 관리 | 앤트로픽·구글·오픈AI 등의 엔지니어가 회사 대표가 아닌 개인 자격으로 관리 |
| 참여 | AAIF에 가입하지 않아도 표준을 쓰고 의견을 낼 수 있음 |
| 앞으로 | 버전을 붙인 정식 판, 변경 제안 절차, 스킬을 만들고 설치하는 사람을 위한 보안 안내(날짜는 없음) |
앤트로픽은 2025년 10월 스킬을 내놓고 12월에 공개 표준으로 풀었습니다. 지금까지 스킬 100만 개가 공개됐고 설치는 2억 8천만 번에 가깝다고 밝혔습니다. 회사가 밝힌 수치입니다. 표준을 받아들인 에이전트 도구는 70곳이 넘고, 챗GPT·커서·깃허브 코파일럿·VS Code가 이름을 올렸습니다.
독자 입장에서 달라지는 점은 하나입니다. 스킬 형식이 한 회사의 것이 아니게 되면서, 한 번 만든 스킬을 여러 AI 도구에서 같이 쓰는 일이 더 자연스러워집니다. MCP가 같은 길을 먼저 걸었습니다(MCP 글).
표준이 정한 규칙
명세가 정한 것은 SKILL.md 맨 위 머리말(—로 감싼 부분)뿐입니다. 본문은 형식 제한이 없습니다. 칸은 6개만 씁니다.
| 칸 | 필수 | 규칙 |
|---|---|---|
| name | 예 | 1~64자, 소문자·숫자·하이픈만. 하이픈으로 시작·끝나거나 두 개 연속 안 됨. 스킬 폴더 이름과 같아야 함 |
| description | 예 | 1~1024자. 무엇을 하는지와 언제 쓰는지 |
| license | 아니오 | 라이선스 이름이나 동봉한 라이선스 파일 |
| compatibility | 아니오 | 500자 이하. 필요한 프로그램·환경 |
| metadata | 아니오 | 그 밖의 정보를 이름-값 짝으로(버전, 만든 사람 등) |
| allowed-tools | 아니오 | 미리 허락할 도구 목록(실험 단계) |
명세는 SKILL.md를 500줄 안쪽으로 두고, 긴 자료는 references 같은 하위 폴더로 빼라고 권합니다. 이 6개 밖의 칸을 쓰면 공식 검사기에서 걸립니다.
1분 점검: 공식 검사기로 내 스킬 검사하기
1단계. 검사기 설치하기 (약 2분)
검사기는 agentskills 저장소에 든 skills-ref입니다. 파이썬 3.11 이상이 필요하고, 작업 폴더 안 가상환경에만 깔리게 합니다. 저장소 설명에 따르면 실서비스용이 아니라 표준을 보여 주는 참고용 도구입니다.
터미널에서 작업할 폴더로 이동해 실행합니다.
git clone --depth 1 https://github.com/agentskills/agentskills.git
python3 -m venv .venv
.venv/bin/pip install -e agentskills/skills-ref
.venv/bin/skills-ref --help
이렇게 나오면 성공 마지막 줄에서 명령 목록 read-properties, to-prompt, validate가 나옵니다.
- “python3: command not found”가 나오면: 파이썬이 없는 것입니다. 맥은 터미널에서
xcode-select --install로 개발 도구를 먼저 깝니다. - “requires a different Python”이 나오면: 파이썬이 3.11보다 낮습니다.
python3 --version으로 확인합니다. - 필요 없어지면 작업 폴더의
.venv와agentskills폴더를 지우면 끝입니다. 다른 곳에는 아무것도 깔리지 않습니다.
2단계. 스킬 하나 검사하기 (약 1분)
검사할 스킬 폴더 경로를 넣습니다. 실습 재료(zip)에 든 연습용 스킬 sales-report-kr로 해 보면 이렇게 나옵니다. 이 스킬은 클로드 코드에서 흔히 쓰는 칸(argument-hint, user-invocable)과 대문자·밑줄이 섞인 이름을 일부러 넣었습니다.
.venv/bin/skills-ref validate sales-report-kr

검사기는 첫 번째 문제인 argument-hint 줄에서 멈췄습니다. 값이 대괄호 [csv 파일 경로]로 시작해서, 검사기가 쓰는 엄격한 YAML(머리말 문법) 읽기가 이를 거부한 것입니다. 따옴표로 감싸면 이 줄은 넘어갑니다.
이렇게 나오면 성공 표준에 맞으면 “Valid skill: 폴더 이름” 한 줄, 아니면 “Validation failed”와 고칠 곳이 나옵니다.
3단계. 내 스킬 폴더 전체 검사하기 (약 1분)
스킬이 많으면 하나씩 넣기 번거롭습니다. zip에 든 check_skills.py는 개인 스킬 폴더(~/.claude/skills, ~/.agents/skills)와 지금 폴더의 스킬을 찾아 한 번에 검사합니다. 파일은 읽기만 합니다.
.venv/bin/python check_skills.py

이 맥의 개인·프로젝트 스킬은 40개 중 38개가 통과했습니다. 걸린 2개는 같은 스킬의 두 사본으로, 대소문자만 다른 userInvocable 칸이 남아 있었습니다.
이렇게 나오면 성공 걸린 스킬마다 “실패”와 이유가 나오고, 맨 아래에 “합계: 통과 N · 실패 N”과 실패 이유 순위가 나옵니다.
- “ModuleNotFoundError: skills_ref”가 나오면:
.venv/bin/python이 아닌 다른 파이썬으로 실행한 것입니다. 1단계 가상환경의 파이썬으로 다시 실행합니다. - “합계: 통과 0 · 실패 0″이면: 그 폴더에 스킬이 없는 것입니다. 스킬 폴더 경로를 뒤에 붙여 실행합니다.
폴더를 주면 그 아래를 검사합니다. 설치된 플러그인 속 스킬 전체를 넣어 봤습니다.
.venv/bin/python check_skills.py ~/.claude/plugins | tail -8

788개를 검사하는 데도 1분이 채 안 걸렸고, 그중 285개가 걸렸습니다. 마켓플레이스 원본과 설치 사본이 함께 있어 같은 스킬을 두 번 센 경우가 들어 있습니다. 실패 이유 1·2위는 argument-hint(141곳)와 user-invocable(73곳)입니다. 둘 다 클로드 코드가 표준에 더해 쓰는 칸입니다. 앤트로픽이 낸 업무용 플러그인 모음(knowledge-work-plugins)의 스킬도 상당수가 이 칸 때문에 걸렸고, 문서 스킬 묶음의 claude-api 스킬은 설명이 1068자라 1024자 제한에 걸렸습니다.
걸렸으면 못 쓰는 걸까
그렇지는 않습니다. 클로드 코드 공식 문서는 클로드 코드 스킬이 에이전트 스킬 표준을 따르면서, 호출 제어 같은 기능을 더 얹는다고 설명합니다. argument-hint는 / 명령 자동 완성 때 보이는 안내이고, user-invocable은 / 메뉴에 보일지를 정합니다(기본값은 보임).
표준 쪽 안내서도 스킬을 읽는 도구에게 너그럽게 읽으라고 권합니다. 이름이 폴더와 다르거나 64자를 넘는 정도는 경고만 하고 불러오라는 것입니다. 건너뛰라고 하는 경우는 description이 없거나 머리말을 아예 읽을 수 없을 때입니다. 그래서 검사기의 “실패”는 “다른 도구에서 안 돈다”가 아니라 “표준 밖의 것이 섞였다”로 읽는 것이 맞습니다. 표에 정리하면 이렇습니다.
| 걸린 이유 | 다른 도구에서 | 고칠지 |
|---|---|---|
| description 없음, 머리말 문법이 깨짐 | 건너뛸 수 있음(안내서 권고) | 꼭 고침 |
| name과 폴더 이름이 다름, 대문자·밑줄 | 경고 뒤 불러올 수 있음 | 고치는 편이 안전 |
| 클로드 코드 전용 칸(argument-hint 등) | 도구마다 다름 | 클로드 코드에서 쓰는 기능이면 남겨도 됨 |
| 설명 1024자 초과 | 도구마다 다름 | 줄이는 편이 좋음 |
클로드 코드에게 표준에 맞게 고쳐 달라고 하면
연습용 스킬을 클로드 코드에게 맡겼습니다. 아래 요청문을 그대로 넣었고, zip에도 들어 있습니다.
sales-report-kr 폴더의 스킬을 Agent Skills 공개 표준(agentskills.io 명세)에 맞게 고쳐 줘.
클로드 코드뿐 아니라 다른 AI 도구에서도 읽히게 하고 싶어. 다 고치면 무엇을 바꿨는지 짧게 알려 줘.
검사기가 없는 폴더에서 두 번, 검사기를 깔아 두고 요청 끝에 “고친 뒤에는 skills-ref validate sales-report-kr로 검사해서 통과하는지 확인해 줘”를 붙여 두 번 돌렸습니다. 결과물은 모두 검사기로 다시 검사했습니다. 채점 기준은 돌리기 전에 명세에서 뽑아 정했습니다. 검사 통과, 이름 규칙, 설명 유지, 표준 밖 칸의 정보 보존, 본문·참고 파일 링크 유지 다섯 가지입니다.
| 조건 | 검사 결과 | 검사기 직접 실행 | argument-hint 처리 | 채점 |
|---|---|---|---|---|
| 검사기 없이 1 | 통과 | 안 돌렸다고 밝힘 | 지우고 설명 끝에 “입력은 csv 파일 경로” 추가 | 5/5 |
| 검사기 없이 2 | 통과 | 안 돌렸다고 밝힘 | 지우고 본문 첫 줄에 입력 안내 | 5/5 |
| 검사기와 함께 1 | 통과 | 돌려서 통과 확인 | metadata 아래로 옮기고 따옴표로 감쌈 | 5/5 |
| 검사기와 함께 2 | 통과 | 돌려서 통과 확인 | 지우고 본문 첫 줄에 입력 안내 | 5/5 |

네 번 모두 이름을 폴더와 같은 sales-report-kr로 바꾸고, version을 metadata로 옮기고, 본문은 그대로 뒀습니다. 한 번에 1분이 채 안 걸렸고 비용은 0.13달러 안팎이었습니다. 검사기 없이도 결과는 맞았지만, 맞는지는 클로드 코드도 확인하지 못했다고 답에 적었습니다. 검사기를 주면 직접 돌려 “통과”를 확인하고 끝냅니다.
좋은 답이라면 무엇을 지웠는지와 그 때문에 사라지는 기능을 함께 말합니다. 네 번 중 세 번은 “클로드 코드에서 / 명령 인자 안내가 더 이상 나오지 않는다”고 먼저 알렸습니다.
여기서 하나 고를 것이 있습니다. argument-hint를 metadata로 옮기면 표준 검사는 통과합니다. 하지만 클로드 코드 문서는 argument-hint를 머리말 맨 위 칸으로만 설명해서, metadata 안으로 옮기면 / 명령 안내가 사라질 수 있습니다. 주로 클로드 코드에서 쓰는 스킬이라면 원래 칸을 두고 따옴표만 감싸는 것도 방법입니다.
한 스킬을 여러 도구에서 같이 쓰려면
표준은 폴더 안 형식만 정하고, 스킬을 어디에 둘지는 정하지 않습니다. 도구마다 읽는 폴더가 달라서, 같이 쓰려면 둘 곳을 맞춰야 합니다.
| 도구 | 읽는 곳 | 참고 |
|---|---|---|
| 클로드 코드 | ~/.claude/skills, 프로젝트의 .claude/skills | 표준에 기능을 더한 칸을 씀 |
| 코덱스(CLI·IDE 확장) | ~/.agents/skills, 프로젝트의 .agents/skills | 오픈AI 문서가 표준 기반이라고 밝힘 |
| 챗GPT 데스크톱 앱 | 문서에 폴더 경로 없음 | 사이드바 Skills 메뉴에서 확인 |
| 커서 | ~/.agents/skills, ~/.cursor/skills, 프로젝트의 .agents·.cursor/skills | 클로드·코덱스 폴더도 함께 읽음 |
표준 안내서는 여러 도구가 같이 보는 자리로 .agents/skills를 권합니다. 클로드 코드는 이 폴더를 읽는다고 문서에 적혀 있지 않으니, 클로드 코드에서도 쓰려면 ~/.claude/skills에 두고 다른 도구용으로 ~/.agents/skills에 사본이나 바로가기(심볼릭 링크)를 둡니다. 코덱스·챗GPT·커서는 직접 돌려 보지 않았고, 이 표는 공식 문서 기준입니다.
한계와 주의할 점
- 검사기는 머리말만 봅니다. 본문 지시가 다른 도구의 모델에서도 똑같이 잘 도는지는 알려 주지 않습니다.
- 남이 만든 스킬은 설치 전에 SKILL.md와 딸린 스크립트를 읽습니다. 표준에 맞는다고 안전하다는 뜻은 아닙니다. 앤트로픽도 보안 안내를 앞으로 만들 일로 꼽았습니다.
대안
터미널이 어렵다면 스킬 표준 검사기에 SKILL.md를 붙여 넣는 것으로 충분합니다. 스킬이 많다면 3단계 스크립트로 한 번에 보고, 걸린 것만 클로드 코드에게 위 요청문으로 맡기면 됩니다. 어떤 스킬부터 깔지는 스킬·플러그인 디렉터리 글에 정리해 두었습니다.
자주 묻는 질문
클로드 스킬을 챗GPT에서도 쓸 수 있나요?
오픈AI 문서에 따르면 챗GPT 데스크톱 앱과 코덱스가 같은 표준의 스킬을 씁니다. 코덱스는 ~/.agents/skills에서 읽습니다. 챗GPT 데스크톱 앱은 문서에 폴더가 나오지 않아 사이드바 Skills 메뉴에서 확인해야 합니다. 클로드 코드 전용 칸은 다른 도구에서 무시되거나 다르게 다뤄질 수 있습니다.
이번 발표로 지금 쓰는 스킬을 고쳐야 하나요?
아닙니다. 앤트로픽은 지금 쓰는 법이 바뀌지 않는다고 밝혔습니다. 다른 도구에서도 같이 쓰고 싶을 때만 검사기로 확인하고 고치면 됩니다.
스킬 표준은 돈이 드나요?
표준과 검사기는 무료이고, 검사기는 아파치 2.0 라이선스입니다. 스킬을 돌리는 AI 도구의 요금은 따로 듭니다.
MCP와 스킬은 뭐가 다른가요?
MCP는 AI가 바깥 프로그램·데이터에 연결하는 통로이고, 스킬은 일하는 순서와 자료를 묶은 설명서입니다. 둘 다 이제 같은 재단(AAIF)이 관리합니다.
출처
앤트로픽 발표(10월 22일), 에이전트 스킬 명세, 스킬 지원 구현 안내서, agentskills 저장소(별 26,445개), 클로드 코드 스킬 문서, 오픈AI 스킬 문서, 커서 스킬 문서 (모두 2026-10-23 확인)