AI 도서관 · Claude · 에이전트 스킬 · 주의사항

claude.ai · API · Claude Code, 스킬은 서로 동기화 안 됨

한 곳에 올린 커스텀 스킬이 다른 곳엔 자동으로 안 뜨는 이유와 대처법

내용

📌 커스텀 스킬은 사용하는 곳(표면)마다 따로 관리돼요.
공식 문서에 '표면 간 동기화되지 않는다'고 명시돼 있습니다.

• claude.ai에 올린 스킬 → API에선 안 보임
• API에 올린 스킬 → claude.ai에선 안 보임
• Claude Code 스킬(~/.claude/skills 또는 .claude/skills) → 둘 다와 별개

🔎 공유 범위도 다릅니다
• claude.ai — 내 계정에만. 팀원은 각자 올려야 함
• API — 워크스페이스 전체 공유
• Claude Code — 개인용/프로젝트용, 플러그인으로도 공유 가능

💡 예외 하나
Cowork·클라우드 세션은 claude.ai 계정에 켜둔 스킬을 세션 시작 때 불러옵니다.
'전혀 안 통한다'가 아니라 '내 컴퓨터의 Claude Code 와는 따로'라고 이해하면 됩니다.

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
세 곳을 각각 따로 관리
주의
공식 문서에 '커스텀 스킬은 표면 간 동기화되지 않는다'고 명시돼 있습니다. 다만 Cowork·클라우드 세션은 claude.ai 계정 스킬을 불러옵니다.
공식 출처
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
확인일
2026-09-08 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기