앤트로픽 공식 개요 문서에 커스텀 스킬은 쓰는 곳끼리 동기화되지 않고 클로드 코드 스킬은 claude.ai·API 와 별개라고 적혀 있어요. claude.ai 는 스킬 폴더를 통째로 담은 zip 을 Customize > Skills 에서 올리면서 '코드 실행 및 파일 생성'을 먼저 켜야 하는 반면, 클로드 코드는 ~/.claude/skills/<이름>/SKILL.md 로 파일만 두면 되고 업로드도 토글도 없어요. 공식 문서가 zip 맨 위에 파일을 흩어 놓은 모양을 잘못된 예시로 따로 그려 둘 만큼 여기서 자주 어긋나는데, 개요 문서는 업로드 위치를 Settings > Features 로 적고 Pro·Max·Team·Enterprise 라 한 반면 도움말 센터는 Customize > Skills 에 Free 까지 포함이라고 적어 둬서 문서끼리도 달라요. 클로드 코드 문서에는 Cowork·클라우드·루틴 세션이 ~/.claude/skills 를 읽지 않고, claude.ai 쪽 스킬을 내려받으려면 CLAUDE_CODE_SYNC_SKILLS=1 을 켠 채 claude -p 로 한 번 돌려야 ~/.claude/skills/synced/ 에 들어온다고 적혀 있어요.
- SKILL.md
- 스킬의 본체가 되는 마크다운 파일. 맨 위에 이름과 설명을 적어 둠
- Cowork
- 앤트로픽이 원격 환경에서 작업을 대신 돌려 주는 제품
- CLAUDE_CODE_SYNC_SKILLS
- claude.ai 계정에 켜 둔 스킬을 내 컴퓨터로 내려받게 하는 클로드 코드 환경변수
- 심볼릭 링크
- 원본 파일이나 폴더를 가리키기만 하는 바로가기 항목
스킬을 저장소 한 곳에 두고 도구 폴더로 심볼릭 링크를 거는 방식은 클로드 코드 로컬 세션까지만 닿아요. claude.ai 는 zip 업로드라 링크가 안 먹고 Cowork·클라우드·루틴은 로컬 폴더를 안 읽으니, 루틴에서 쓸 스킬은 저장소의 .claude/skills 에 커밋하거나 플러그인으로 넣어 두는 쪽이 확실해요.
- 공식 문서가 한자리에서 갈라 적은 것 커스텀 스킬은 올린 곳 밖으로 따라가지 않고, 클로드 코드 스킬은 파일 기반이라 claude.ai·API 양쪽과 별개라고 적혀 있어요. Anthropic
- claude.ai 쪽 zip 모양 zip 안에 스킬 폴더가 통째로 들어간 것이 맞는 구조이고, 파일을 zip 맨 위에 흩어 놓은 것은 틀린 예시로 그려져 있어요. Anthropic
- 클로드 코드 쪽 폴더와 내려받기 Cowork·클라우드·루틴 세션은 ~/.claude/skills 를 읽지 않고, claude.ai 계정 스킬은 환경변수를 켠 비대화형 실행에서만 ~/.claude/skills/synced/ 로 들어와요. Anthropic
- 도움말 센터는 다르게 적어 뒀어요 여는 곳을 Customize > Skills 로 적고 Free 플랜까지 포함이라고 해서, 개요 문서의 Settings > Features 및 Pro 이상 서술과 어긋나요. Anthropic Help Center