Claude Code, Codex, Cursor에 스킬을 설치하는 방법

Q: Claude Code용 스킬은 어디에 두나요?

모든 프로젝트에서 쓰려면 ~/.claude/skills/ /, 프로젝트 하나에서만 쓰려면 그 프로젝트 안의 .claude/skills/ /에 둡니다. 폴더 이름은 스킬 이름 그대로이며, 안에 SKILL.md가 있습니다. 새 Claude Code 세션을 시작해 스킬을 불러오게 하세요.

Q: 스킬이 Codex, Cursor, Gemini CLI에서도 작동하나요?

네. 같은 폴더가 모두에서 작동하며, 위치만 다릅니다. Codex는 ~/.agents/skills/ /, Cursor는 프로젝트 안의 .cursor/skills/ /, Gemini CLI는 ~/.gemini/skills/ /입니다.

스킬은 SKILL.md 파일(에이전트를 위한 지시문)과 템플릿, 스크립트가 든 폴더입니다. 한 번 설치하면 요청이 맞을 때마다 에이전트가 사용합니다. 같은 폴더가 Claude Code, Codex, Cursor, Gemini CLI에서 모두 작동하며, 두는 위치만 다릅니다.

폴더 위치는 2026년 10월 29일 기준 각 에이전트의 공식 문서에서 확인했습니다.

스킬이란

스킬은 공개 형식인 Agent Skills를 따릅니다. 스킬 하나는 스킬 이름을 딴 폴더 하나이며, 다음이 들어 있습니다.

SKILL.md: 지시문. 짧은 헤더에 스킬의 name과 언제 쓰는지를 적은 description이 있습니다. 에이전트는 description을 읽고 요청이 맞는지 판단하며, 맞으면 나머지를 읽습니다.
참고 자료: 지시문이 가리키는 더 긴 메모로, 필요할 때만 읽습니다.
템플릿과 스크립트: 에이전트가 복사하거나 실행하는 파일입니다. 영상 템플릿, 브리프 파일, 검사 등이 있습니다.

시스템 전체에 설치되는 것은 없고 계정도 만들어지지 않습니다. 에이전트가 폴더를 읽고, 스킬의 명령은 내 프로젝트 안에서 실행됩니다.

가장 빠른 방법: 에이전트에게 맡기기

아무 스킬 페이지에서 설치 프롬프트를 복사해 에이전트에 붙여 넣으세요.

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

에이전트가 가이드를 읽고 명령 하나, npx motion-skills install <slug>를 실행합니다. 처음에는 브라우저에 페이지가 열립니다. Google로 로그인하고 터미널에 표시된 코드를 승인하세요. 아직 갖고 있지 않은 유료 스킬이라면 같은 페이지에서 구매할 수 있고, 설치는 자동으로 끝납니다. 그다음 에이전트가 첫 영상을 만듭니다. (명령을 실행할 수 없으면 가이드가 브라우저 다운로드로 안내합니다.)

직접 설치

스킬 페이지에서 ZIP을 다운로드합니다.
폴더 이름이 그대로 유지되도록 압축을 풉니다(<slug>/SKILL.md).
- Claude Code: ~/.claude/skills/<slug>/, 또는 프로젝트 안의 .claude/skills/<slug>/
- Codex: ~/.agents/skills/<slug>/
- Cursor: 프로젝트 안의 .cursor/skills/<slug>/
- Gemini CLI: ~/.gemini/skills/<slug>/
에이전트 세션을 새로 시작해 스킬을 불러오게 합니다.

mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

컴퓨터에 필요한 것

Node.js 22 이상
FFmpeg(macOS에서는 brew install ffmpeg)
Google Chrome(렌더러가 헤드리스 모드로 구동합니다)

완성 영상 스킬과 무료 Motion Director 스킬은 저희 오픈 엔진 motion-skills(mo)로 작동하며, 처음 렌더링할 때 npx로 스스로 설치됩니다. 모션 템플릿은 HyperFrames CLI를 쓰며, 같은 방식으로 스스로 설치됩니다. API 키는 필요하지 않습니다.

스킬 사용하기

모션 템플릿이라면 그냥 요청하세요. "Ship faster, sleep better라고 쓰인 9:16 타이틀 카드를 만들어 줘." 에이전트가 템플릿을 복사하고, brief.json을 작성하고, hyperframes check를 실행하고, 스냅샷 프레임을 보며 레이아웃 문제를 잡은 뒤, MP4를 렌더링하고 어디에 있는지 알려 줍니다.

완성 영상 스킬이라면 에이전트에 자료를 주고 영상의 용도를 말하세요. 스킬이 세 가지 연출 방향을 실제 프레임으로 보여 주고, 리듬 시트와 오리지널 음악을 쓰고, mo 검사와 리뷰를 거친 뒤, 내 Chrome에서 MP4를 렌더링합니다.

실제 예시 영상이 있는 전체 안내는 Claude Code로 영상 만드는 방법을 보세요. Codex, Cursor, Gemini CLI에서 각 에이전트가 읽는 모든 폴더와 함께 보려면 Codex, Cursor, Gemini CLI로 영상 만들기를 참고하세요.

문제 해결

에이전트가 스킬을 쓰지 않습니다. 설치 후 새 세션을 시작하세요. 에이전트는 세션이 시작될 때 스킬을 읽습니다(Gemini CLI에서는 /skills reload로 세션 안에서 다시 읽을 수 있습니다). 그다음 스킬 이름을 넣어 다시 요청하세요. 예: "use the changelog-video skill". 폴더도 확인하세요. SKILL.md는 <slug>/ 바로 안에 있어야 하며, 압축을 푼 뒤 한 단계 더 깊이 들어가 있으면 안 됩니다.
"FFmpeg not found". FFmpeg를 설치하고(macOS에서는 brew install ffmpeg) 새 터미널을 열어 경로에 잡히게 하세요.
"Chrome not found". Google Chrome을 설치하세요. 렌더러가 헤드리스 모드로 구동합니다. 완성 영상 스킬은 mo doctor로, 모션 템플릿은 node kit/doctor.mjs로 이것을 먼저 확인해 줍니다.
로그인 페이지가 열리지 않습니다. 터미널에 주소와 코드가 출력됩니다. 주소를 직접 열고 코드를 입력하세요.

자주 묻는 질문

Claude Code용 스킬은 어디에 두나요?

모든 프로젝트에서 쓰려면 ~/.claude/skills/<slug>/, 프로젝트 하나에서만 쓰려면 그 프로젝트 안의 .claude/skills/<slug>/에 둡니다. 폴더 이름은 스킬 이름 그대로이며, 안에 SKILL.md가 있습니다. 새 Claude Code 세션을 시작해 스킬을 불러오게 하세요.

SKILL.md란 무엇인가요?

에이전트를 위한 지시문 파일로, 템플릿과 스크립트가 함께 든 스킬 폴더 안에 있습니다. 헤더에 스킬 이름과 언제 쓰는지가 적혀 있으며, 요청이 맞으면 에이전트가 읽습니다.

스킬이 Codex, Cursor, Gemini CLI에서도 작동하나요?

네. 같은 폴더가 모두에서 작동하며, 위치만 다릅니다. Codex는 ~/.agents/skills/<slug>/, Cursor는 프로젝트 안의 .cursor/skills/<slug>/, Gemini CLI는 ~/.gemini/skills/<slug>/입니다.

API 키가 필요한가요?

아니요. 스킬은 Node.js, FFmpeg, Chrome으로 내 컴퓨터에서 실행되며, 엔진은 npx로 스스로 설치됩니다. 필요한 로그인은 다운로드를 위한 이 사이트의 무료 Google 계정 하나뿐입니다.