코덱스·커서에서 클로드 스킬 쓰는 법

스킬은 SKILL.md와 필요한 참고 자료·스크립트를 담은 폴더예요. 이름, 설명, 작업 지침이라는 공통 형식을 여러 AI 도구가 지원해요.

기본적인 작업 절차는 재사용할 수 있지만 Claude Code 전용 설정이나 명령까지 그대로 동작한다는 뜻은 아니에요. 옮길 때는 지원 도구, 실행 프로그램, 필요한 연결부터 확인해 주세요.

Claude Code는 프로젝트의 .claude/skills와 개인용 ~/.claude/skills를 지원해요. Codex는 프로젝트의 .agents/skills와 개인용 ~/.agents/skills를 사용해요.

Cursor는 .cursor/skills를 비롯해 호환용 스킬 폴더도 지원해요. 읽는 경로와 우선순위는 도구별로 다르니 아래 공식 문서에서 현재 버전의 경로를 확인해 주세요. 폴더를 옮긴 뒤에는 새 세션에서 스킬 목록을 살펴봐요.

같은 스킬을 여러 폴더에 복사하면 수정한 버전이 서로 달라질 수 있어요. 팀에서 원본으로 관리할 위치를 정하고 다른 도구에 전달하는 방법도 함께 기록해 주세요.

심볼릭 링크로 원본을 가리키는 방법을 사용할 수도 있어요. 운영체제와 도구의 링크 지원을 확인한 뒤 적용하고, 기존 폴더가 있다면 먼저 내용을 확인해요. 팀용 스킬은 저장소에서, 개인용 스킬은 개인 폴더에서 관리하면 구분하기 좋아요.

AGENTS.md에는 수정 범위, 실행 명령, 검증 방법처럼 프로젝트에서 반복해서 필요한 규칙을 적어요. 스킬에는 보고서 작성이나 코드 리뷰처럼 특정 작업의 절차를 담아요.

Claude Code에서는 CLAUDE.md를 같은 목적에 사용할 수 있어요. 공통 내용을 한곳에 관리하려면 지원되는 문서 참조 방식을 사용해 주세요. 여러 파일에 상반된 규칙을 적지 않도록 확인해요.

먼저 AI가 해당 SKILL.md를 읽었는지 확인해 보세요. 목록에 없다면 폴더 위치와 파일 형식을, 목록에 있지만 선택되지 않았다면 설명과 호출 방법을 살펴봐요.

스킬을 읽었는데 실패한다면 실행 프로그램, MCP 연결, 권한, 프로젝트 지침을 확인해요. 사용하는 모델도 결과에 영향을 줄 수 있어요. 기대 결과와 실제 결과의 차이를 구체적으로 적어 수정해 주세요.

서로 다른 폴더에 같은 이름의 스킬이 있으면 어느 버전이 선택되는지 확인하기 어려워요. 각 도구의 우선순위를 확인하고 불필요한 복사본을 정리해요.

폴더명과 SKILL.md의 이름 설정도 함께 살펴봐 주세요. 이름을 정하는 규칙은 도구에 따라 차이가 있으므로 폴더명만 바꾸면 모두 해결된다고 가정하지 않아요.

먼저 쓰던 도구에서 간단한 작업의 입력과 결과를 남겨요. 같은 스킬을 새 도구에서 불러 같은 입력으로 실행한 뒤 결과 형식과 빠진 단계를 비교해 보세요.

한 번 성공한 뒤에도 모델이나 연결 서비스가 바뀌면 다시 확인할 수 있어요. 사용한 도구와 필요한 설정을 스킬 설명에 남겨 두면 다음에 옮길 때 편해요.