클로드코드 스킬 설치 방법 - 실사용 10개와 보안 점검

클로드코드 스킬을 처음 찾아보면 설치 방법이 저장소마다 달라서 헷갈립니다. 어떤 곳은 폴더를 복사하라고 하고, 어떤 곳은 '/plugin' 명령을 쓰라고 하고, 어떤 곳은 'npx'로 설치하라고 합니다. 이름은 다 '스킬'인데 실제로는 스킬, 플러그인, 서브에이전트가 섞여 있기 때문입니다.

이 글은 제가 지난 3개월 동안 실제로 가장 많이 쓴 스킬 10개를 기준으로, 클로드 스킬의 뜻부터 설치 방법, 만드는 법, 코덱스와의 차이, 설치 전 보안 점검까지 정리했습니다. 개념과 경로는 Anthropic과 OpenAI의 공식 문서를, 스킬별 설치 방법과 라이선스는 각 GitHub 저장소의 README를 2026년 9월 23일에 확인해 적었습니다.

클로드 스킬 뜻: 필요할 때만 불러오는 작업 설명서

공식 문서는 스킬을 이렇게 정의합니다.

Skills extend what Claude can do. Create a SKILL.md file with instructions, and Claude adds it to its toolkit.

쉽게 말하면 'SKILL.md'라는 파일 하나에 일하는 방법을 적어두면, 클로드가 관련 있는 요청이 올 때 알아서 꺼내 쓰는 구조입니다. 직접 부르고 싶으면 '/스킬이름'으로 호출합니다.

CLAUDE.md와 다른 점은 불러오는 시점입니다. CLAUDE.md는 매번 읽히지만, 스킬 본문은 쓸 때만 읽힙니다. 공식 문서는 그래서 긴 참고 자료도 필요해지기 전까지는 비용이 거의 들지 않는다고 설명합니다. 예전의 커스텀 명령('.claude/commands/')도 지금은 스킬로 합쳐졌고, 기존 파일은 그대로 작동합니다.

클로드 코드 스킬 설치 방법: 폴더 위치 두 곳만 기억하세요

공식 문서 기준으로 직접 설치하는 스킬은 폴더를 어디에 두느냐로 적용 범위가 갈립니다.

위치	경로	적용 범위
개인	~/.claude/skills/스킬이름/SKILL.md	내 컴퓨터의 모든 프로젝트
프로젝트	.claude/skills/스킬이름/SKILL.md	해당 저장소. 커밋하면 팀과 공유
플러그인	플러그인 폴더/skills/스킬이름/SKILL.md	'/플러그인이름:스킬이름'으로 호출

폴더 이름이 곧 명령어가 됩니다. 폴더에 심볼릭 링크를 걸어도 되고, 'synced'라는 폴더명은 예약어라 쓸 수 없습니다.

클로드코드 플러그인 설치 방법

여러 스킬이나 에이전트, 훅, MCP 서버를 한 묶음으로 배포하는 형태가 플러그인입니다. 설치는 두 단계입니다.

1. '/plugin marketplace add 저장소주소'로 마켓플레이스를 추가합니다.
2. '/plugin install 플러그인이름@마켓플레이스이름'으로 설치합니다.

Anthropic 공식 마켓플레이스는 처음 대화형으로 실행할 때 자동으로 추가됩니다. 주의할 점은 자동 업데이트입니다. 공식 문서에 따르면 자동 업데이트 기본값은 마켓플레이스 종류에 따라 다르고, 서드파티 마켓플레이스는 기본으로 꺼져 있습니다. 새 버전을 받으려면 '/plugin' 메뉴에서 자동 업데이트를 켜거나 '/plugin marketplace update'로 직접 갱신하면 됩니다.

클로드 코드 스킬 적용이 안 될 때

플러그인으로 설치한 스킬은 이름 앞에 플러그인 이름이 붙습니다. 예를 들어 frontend-slides를 플러그인으로 설치하면 '/frontend-slides:frontend-slides'로, 폴더에 직접 복사하면 '/frontend-slides'로 부릅니다. 설치했는데 명령이 안 먹는다면 이 차이부터 확인하세요. 플러그인 설치 직후에는 '/reload-plugins'로 다시 불러오라고 안내하는 저장소도 있습니다.

제가 실제로 쓰는 클로드 스킬 추천 10개

아래는 제 최근 3개월 작업 기록에서 사용 빈도가 높았던 순서가 아니라 업무 흐름 순서입니다. '설치 형태' 열이 중요합니다. 같은 스킬이라도 설치 형태에 따라 명령어가 달라집니다.

스킬	용도	설치 형태(README 기준)	라이선스	최근 커밋
Korean Vibe Fonts	한국어 웹폰트 조합 추천	README는 서브에이전트 파일 생성 방식 안내	미지정	2026-07-31
insane-search	차단된 공개 페이지 읽기	플러그인	MIT	2026-09-08
claude-seo	SEO 점검	플러그인 또는 설치 스크립트	MIT	2026-09-11
diagram-design	HTML·SVG 도표	플러그인 또는 심볼릭 링크	MIT	2026-09-19
god-tibo-imagen	코덱스 인증으로 이미지 생성	스킬 폴더 복사 또는 npx skills add	package.json에만 MIT	2026-09-19
frontend-slides	HTML 발표자료	플러그인 또는 폴더 복사	MIT	2026-06-23
taste-skill	프런트엔드 디자인 기준	npx skills add	MIT	2026-09-23
Anthropic Data	데이터 탐색·검증·시각화	플러그인	Apache-2.0	2026-09-21(data 폴더)
claude-mem	지난 세션 기록 검색	npx claude-mem install 또는 플러그인	Apache-2.0	2026-09-21
NolanX skills 폴더	영상 기획·스토리보드	README에 클로드코드 설치법 없음	MIT	2026-05-15(skills 폴더)

'모두 MIT 오픈소스'라고 한 줄로 정리하는 소개 글이 많은데, 표에서 보듯 사실이 아닙니다. Korean Vibe Fonts는 라이선스 표시가 없고, god-tibo-imagen은 LICENSE 파일 없이 package.json에만 MIT가 적혀 있습니다.

1. Korean Vibe Fonts: 한국어 페이지가 촌스러울 때

제가 만든 스킬입니다. 제목과 본문 폰트 조합, 굵기, 자간까지 한국어 콘텐츠 분위기에 맞춰 골라줍니다. 컬러도 사진도 괜찮은데 페이지가 어딘가 어색할 때, 저는 폰트부터 바꿉니다. "일본 스타일에 모찌 브랜드 홈페이지"라고 요청하면 그 분위기에 맞는 조합을 제안합니다.

솔직하게 적자면 README의 클로드코드 설치 안내는 서브에이전트 파일('.claude/agents/')을 만드는 방식입니다. 지금 공식 문서는 스킬 폴더 방식을 지원하므로 README도 이에 맞게 손볼 예정입니다. 저장소 루트에 SKILL.md가 있긴 하지만, 스킬 폴더에 복사했을 때 동작하는지는 README에 적힌 방법이 아니어서 여기서 보장하지 않습니다.

2. insane-search: 크롤링이 막힌 공개 페이지를 읽을 때

README 설명으로는 차단된 요청을 만나면 0단계부터 3단계까지 방법을 바꿔가며 공개 페이지를 읽어오는 도구입니다. 저는 매일 AI 소식을 모을 때 씁니다. 가입이나 API 키는 필요 없고 첫 실행 때 필요한 패키지를 자동으로 설치합니다. 로그인이나 유료 벽이 있는 페이지는 'authentication required'로 멈춥니다.

설치는 플러그인 방식입니다. README 순서대로 마켓플레이스를 추가하고 'insane-search@gptaku-plugins'를 설치한 뒤 '/reload-plugins'를 실행합니다. 외부 페이지를 가져오는 스킬이라 아래 보안 점검 항목에 특히 해당합니다.

3. claude-seo: 쓰기 전에 검색 의도부터 볼 때

저장소 설명 기준으로 하위 스킬 25개와 서브에이전트 18개를 묶은 SEO 플러그인입니다. 기술 SEO, 콘텐츠, 스키마, 사이트맵에 더해 지금은 AI 검색 대응과 백링크 영역까지 들어 있습니다. README가 Python 3.10 이상을 요구하고, 판단이 무거운 에이전트 5개는 v2.3.1부터 Opus로 돌아서 전체 감사를 돌리면 사용량이 전보다 늘었다고 스스로 밝힙니다. 사용량 한도가 빠듯한 요금제라면 전체 감사보다 페이지 단위 점검부터 쓰는 편이 낫습니다.

4. diagram-design: 설명을 도표로 옮길 때

흐름도나 비교표를 그릴 때 어디서부터 읽어야 하는지 시선 순서를 잡아줍니다. 결과물은 HTML과 SVG로 나옵니다. 클로드코드와 코덱스 양쪽 설치 명령을 README가 모두 안내합니다. 서드파티 마켓플레이스라 자동 업데이트를 따로 켜야 한다는 안내도 README에 있습니다.

5. god-tibo-imagen: 클로드코드에서 이미지를 만들 때

로컬 코덱스 로그인 정보를 재사용해 코덱스 쪽 이미지 생성 기능을 부르고 PNG로 저장하는 도구입니다. 명령어는 'gti'입니다. 다만 README가 직접 이렇게 경고합니다.

This is not a supported public API integration. It depends on private Codex request behavior that may change without notice.

공식 API가 아니어서 언제든 막힐 수 있다는 뜻입니다. 실제로 제 작업 환경에서는 8월 말과 9월 초에 요청 오류가 반복돼 지금은 다른 방법으로 이미지를 만들고 있습니다. 요금 조건도 README에는 '이미지 생성 권한이 있는 Codex/ChatGPT 계정'이라고만 나옵니다. OpenAI 공식 요금 문서에 따르면 코덱스 이미지 생성은 무료 요금제에서 쓸 수 없습니다. 어떤 유료 요금제부터 이 도구가 동작하는지는 확인하지 못했습니다.

6. frontend-slides: HTML 한 장으로 발표자료를 만들 때

프레임워크 없이 HTML 파일 하나로 슬라이드를 만들거나 기존 PPT를 웹 슬라이드로 옮깁니다. PPT 변환에는 Python과 python-pptx가, PDF 내보내기에는 Node.js가 필요합니다. 마지막 커밋이 2026년 6월 23일이라 석 달 가까이 업데이트가 없다는 점은 알고 쓰시면 됩니다.

7. taste-skill: 흔한 AI 디자인에서 벗어나고 싶을 때

디자인 변화 폭, 모션 강도, 정보 밀도를 1에서 10 사이 값으로 먼저 정하고 그 기준에 맞춰 화면을 만들게 합니다. 단일 스킬이 아니라 여러 스킬 묶음이고, 기본 스킬은 현재 'v2 (experimental)'로 표시돼 있습니다. 저는 카드뉴스 디자인 시안을 잡을 때 썼습니다.

8. Anthropic Data 플러그인: 엑셀을 열고 어디부터 볼지 막힐 때

Anthropic 공식 조직 저장소에 있는 플러그인입니다. 데이터 탐색, 검증, SQL, 통계, 시각화, 대시보드 명령을 제공합니다. 플러그인이라 명령어 앞에 플러그인 이름이 붙습니다. 데이터 웨어하우스를 연결하면 가장 잘 동작하지만, 연결 없이도 CSV나 엑셀 파일을 올려 분석할 수 있다고 README에 나옵니다. 원래 Cowork용으로 만들었고 클로드코드에서도 동작한다고 설명합니다.

9. claude-mem: '그때 그 작업 어디 있지?' 할 때

클로드코드 세션을 기록해두고 나중에 주제나 날짜로 다시 찾게 해줍니다. 이 글의 스킬 목록도 claude-mem으로 지난 3개월 기록을 검색해서 뽑았습니다.

설치 전에 알아둘 변화가 있습니다. 최신 README 기준으로 설치하면 브라우저 로그인을 요청하고, 로그인하면 처음 30일은 무료이며 그 뒤 구독하지 않으면 사용자의 Anthropic 요금제로 자동 전환됩니다. 로그인 없이 설치하는 옵션도 README에 있습니다. 또 'npm install -g claude-mem'은 플러그인 훅을 등록하지 않는다고 README가 경고하니 README의 권장 명령으로 설치하세요.

10. NolanX skills 폴더: 영상 시놉시스부터 스토리보드까지

제가 'Nolanx Video Skills'라고 불러온 것은 공식 이름이 아니라, 영상 제작 에이전트 NolanX 저장소 안의 skills 폴더입니다. 카메라 앵글, 장면 배치, 연속성, 스토리보드 같은 스킬 20개가 들어 있습니다. README에는 클로드코드나 코덱스용 설치 방법이 없어서, 저는 필요한 SKILL.md를 참고 자료로 읽혀서 씁니다.

'한국 드라마 김치 싸대기 장면 비화 영상' 한 줄로는 영상이 안 나왔습니다. 이 스킬로 이야기를 8개 비트와 21개 숏으로 먼저 쪼개고 9:16 세로 화면, 24fps 기준으로 앵글과 장면 연결을 정한 뒤 만들었더니 82.6초짜리 영상이 나왔습니다. 실제 영상 생성은 힉스필드 MCP로 했습니다. 힉스필드 MCP는 별도 API 키 없이 기존 플랜 크레딧을 쓰는 구조라, 이미 힉스필드를 쓰고 있다면 클로드에서 바로 연결할 수 있습니다.

힉스필드 링크 로그인하고 3시간 최대 50% 할인 링크제휴 링크: 이 링크로 구매하면 Fieldnotes가 수수료를 받습니다.

이 할인은 제휴 링크로 로그인한 시점부터 3시간 동안 적용되는 개인별 혜택입니다. 실제 할인 폭은 로그인 후 결제 화면에서 확인하세요.

클로드 스킬 만드는 법: 폴더 하나, 파일 하나

직접 만드는 것도 어렵지 않습니다. 공식 문서의 첫 예제 흐름은 이렇습니다.

1. '~/.claude/skills/스킬이름' 폴더를 만듭니다.
2. 그 안에 SKILL.md를 만들고 맨 위 '---' 사이에 description을 씁니다. 클로드는 이 설명을 보고 언제 스킬을 쓸지 판단합니다.
3. 그 아래에 작업 순서와 규칙을 평소 말투로 적습니다.
4. 설명과 맞는 요청을 하거나 '/스킬이름'으로 불러 테스트합니다.

프런트매터 필드는 모두 선택이고 description만 권장입니다. description과 when_to_use를 합쳐 1,536자를 넘으면 잘리니 핵심 트리거를 앞에 두세요. 스크립트나 템플릿 같은 보조 파일도 같은 폴더에 둘 수 있습니다. 같은 지시를 채팅에 반복해서 붙여 넣고 있다면 그게 스킬로 만들 후보라고 공식 문서는 안내합니다.

코덱스 스킬 쓰는법: 같은 표준, 다른 경로

'클로드코드로 배우면 코덱스에서도 똑같다'고 제가 예전에 쓴 적이 있는데, 공식 문서를 다시 확인해보니 대체로 맞지만 완전히 같지는 않습니다. 둘 다 같은 오픈 Agent Skills 표준의 SKILL.md를 쓰지만 경로, 호출 방식, 필수 필드가 다릅니다.

항목	클로드코드	코덱스
개인 스킬 경로	~/.claude/skills	~/.agents/skills
프로젝트 스킬 경로	.claude/skills	.agents/skills
직접 호출	/스킬이름	/skills 또는 $스킬이름
프런트매터	모두 선택(description 권장)	name과 description 필수

일부 저장소 README는 코덱스 경로로 '~/.codex/skills/'를 안내합니다. 현재 OpenAI 공식 문서 표에는 이 경로가 없고 '~/.agents/skills'가 적혀 있습니다. 예전 경로가 지금도 읽히는지는 확인하지 못했으니 공식 경로를 쓰는 편이 안전합니다.

서드파티 스킬 설치 전 보안 점검

스킬은 지시문만 있는 게 아니라 스크립트를 실행할 수 있습니다. Anthropic 공식 문서의 권고는 분명합니다.

Use Skills only from trusted sources: those you created yourself or obtained from Anthropic.

플러그인 문서도 플러그인과 마켓플레이스가 사용자 권한으로 임의 코드를 실행할 수 있는 구성요소라고 설명합니다. 제가 설치 전에 보는 항목은 네 가지입니다.

• SKILL.md와 scripts 폴더 전체: 설명과 상관없는 네트워크 호출이나 파일 접근이 있는지 봅니다.
• allowed-tools 필드: 공식 문서에 따르면 스킬이 스스로 넓은 도구 권한을 가질 수 있고, 워크스페이스 신뢰 설정이 이 필드를 막지 않습니다.
• 외부 페이지를 가져오는 스킬인지: 공식 문서는 외부 URL에서 데이터를 가져오는 스킬을 특히 위험한 유형으로 꼽습니다. 가져온 내용에 악성 지시가 섞일 수 있어서입니다. 위 목록에서는 insane-search가 여기에 해당합니다.
• 로그인·인증 정보를 쓰는지: god-tibo-imagen은 로컬 코덱스 인증 파일을 재사용하고, claude-mem은 설치 중 외부 서비스 로그인을 요청합니다.

클로드 스킬 무료로 쓸 수 있나요

스킬 자체에 따로 붙는 요금은 공식 문서에 없습니다. 다만 클로드코드를 쓰려면 유료 계정이 필요합니다. 공식 설치 문서는 무료 claude.ai 요금제에는 클로드코드가 포함되지 않고 Pro, Max, Team, Enterprise 또는 Console 계정이 필요하다고 적고 있습니다. Pro와 Max는 구독 사용량에 포함되고, Console(API)은 토큰 사용량만큼 과금됩니다. 스킬을 돌리는 것도 토큰을 쓰니 claude-seo 전체 감사처럼 무거운 작업은 사용량이 빨리 줄어듭니다.

자주 묻는 질문

스킬과 플러그인 중 무엇으로 설치해야 하나요?

혼자 쓰거나 빨리 시험해볼 거라면 스킬 폴더에 직접 두는 방식이 간단합니다. 업데이트를 받아야 하거나 여러 스킬이 한 묶음으로 오는 경우는 저장소가 권장하는 플러그인 방식을 따르세요. 공식 문서도 개인 작업과 실험은 단독 구성을, 팀 공유와 버전 배포는 플러그인을 권합니다.

클로드 스킬 공유는 어떻게 하나요?

프로젝트의 '.claude/skills/' 폴더를 저장소에 커밋하면 그 저장소를 쓰는 사람에게 공유됩니다. 더 넓게 배포하려면 플러그인으로 묶습니다.

코덱스에서 만든 스킬을 클로드코드에서 써도 되나요?

같은 SKILL.md 표준이라 대부분 옮겨 쓸 수 있습니다. 폴더를 클로드코드 경로로 옮기고, 코덱스 전용 파일(agents/openai.yaml 등)이나 '$' 호출을 전제로 한 문구가 있으면 고치면 됩니다.

정리

클로드코드 스킬 설치는 결국 세 가지 중 하나입니다. 스킬 폴더에 두기, 플러그인으로 설치하기, 저장소가 제공하는 설치 명령 쓰기. 어느 방식이든 README에 적힌 방법을 따르고, 설치 전에 SKILL.md와 스크립트, allowed-tools를 한 번 열어보는 습관이 가장 중요합니다. 처음이라면 Anthropic 공식 저장소의 Data 플러그인처럼 출처가 분명한 것부터 시작하고, 자주 반복하는 지시가 생기면 그걸 내 스킬로 만들어보세요.

클로드코드를 처음부터 차근차근 배우고 싶다면 제가 만든 비개발자를 위한 클로드코드 업무 자동화 인프런 강의도 있습니다.

이 글에는 제휴 링크가 포함되어 있으며, 링크를 통해 가입하시면 일정 수수료를 제공받습니다.