skill은 코딩 에이전트가 기본으로는 잘 못하는 걸 가르치는 가장 쉬운 방법이에요. 디자인 기준, 리뷰 체크리스트, 토큰 아끼는 요령 같은 것들이죠. 이 가이드에서는 Claude Code와 Codex의 skill이 어디에 있는지, 직접 설치하는 법, 명령줄 없이 관리하는 법을 설명해요.
skill이란?
skill은 SKILL.md 파일이 든 폴더예요. 맨 위에 짧은 이름과 설명이 있는 Markdown 지침과, 필요한 스크립트나 참고 파일로 이뤄져 있어요. 에이전트는 설치된 skill의 설명만 읽어 두었다가 작업에 필요할 때 전체 지침을 불러와요. 그래서 설치된 skill은 실제로 쓰이기 전까지 컨텍스트를 거의 차지하지 않아요.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Claude Code와 Codex는 skill을 어디서 찾나요?
| 에이전트 | 개인 skill(모든 프로젝트) | 프로젝트 skill |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
저장소 안의 .claude/skills/<name>/ |
| Codex | ~/.codex/skills/<name>/ 또는 ~/.agents/skills/<name>/ |
Codex 문서 참고 |
CLAUDE_CONFIG_DIR이나 CODEX_HOME을 설정했다면 개인 폴더도 그 경로를 따라 옮겨가요.
skill 직접 설치하기
- skill의 저장소와
SKILL.md가 들어 있는 폴더를 찾아요. - 그 폴더를 skills 디렉터리에 복사해요.
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- 새 에이전트 세션을 시작해야 skill이 인식돼요.
업데이트하려면 복사를 다시 해야 하고, 새 버전이 말썽을 부려도 되돌릴 방법이 없어요. 그러니 이전 폴더는 백업해 두세요.
믿을 수 있는 skill만 설치하세요. skill에는 에이전트가 내 권한으로 실행할 수 있는 스크립트가 들어 있을 수 있어요. SKILL.md와 스크립트를 먼저 읽어 보세요.
Vibe Console로 내 skill 저장소 관리하기
Vibe Console의 Skills 패널에서 믿을 수 있는 GitHub 저장소를 owner/repo 또는 https://github.com/owner/repo 형식으로 추가하세요. 카드를 넣을 섹션을 고른 다음, Claude Code나 Codex에 설치할 skill을 선택하면 돼요. 목록은 내 Mac에 저장되고, Vibe Console이 skill 파일을 제공하지는 않아요. 이미 설치한 건 그대로 둔 채 목록에서 카드만 지울 수도 있어요.
롤백이 되는 안전한 업데이트
Vibe Console은 설치된 skill의 업데이트를 확인해서 업데이트 있음으로 표시하고, 디스크의 파일이 원본과 달라졌으면 소스가 다름 — 변경 사항 검토로 표시해요. 업데이트할 때는 이전 파일을 백업해 둬요. 새 버전에서 문제가 생기면 롤백을 누르거나, 백업 열기로 이전 파일을 살펴볼 수 있어요.
자주 묻는 질문
skill은 Claude Code와 Codex 둘 다에서 동작하나요?
SKILL.md 형식은 양쪽 모두에서 동작하지만, 에이전트마다 자기 폴더에서 skill을 불러와요. 쓰는 에이전트마다 따로 설치하세요.
설치된 skill 때문에 에이전트가 느려지나요?
거의 그렇지 않아요. 작업에 필요해지기 전까지 에이전트는 각 skill의 짧은 설명만 읽어요.
skill은 어떻게 지우나요?
skills 디렉터리에서 해당 폴더를 지우고 새 세션을 시작하세요.
Skills 패널을 14일 동안 무료로 써 보세요: Vibe Console 다운로드.