에이전트 스킬 설치 방법

스킬은 SKILL.md 파일이 포함된 폴더일 뿐입니다. 스킬을 설치한다는 것은 해당 폴더를 에이전트에 맞는 올바른 위치에 놓는 것입니다. 각 도구별 위치는 다음과 같습니다.

공통 접근 방식

모든 에이전트는 특정 디렉토리에서 스킬을 읽습니다. 두 가지 범위가 있습니다:

프로젝트 스킬

리포지토리 내에 위치. 버전 관리에 커밋됨. 해당 프로젝트에서 작업하는 모든 사람이 사용 가능.

개인 스킬

홈 디렉토리에 위치. 모든 프로젝트에서 사용 가능. 본인만 사용 가능.

수동으로 다운로드 및 저장

가장 간단한 방법 — CLI 도구 불필요:

mdskills.ai에서 스킬을 찾고 상세 페이지에서 다운로드 버튼을 클릭하세요.
프로젝트에 스킬 폴더를 생성하세요. 예를 들어, Claude Code의 경우:
mkdir -p .claude/skills/my-skill
해당 폴더 안에 파일을 SKILL.md (으)로 저장하세요:
mv ~/Downloads/SKILL.md .claude/skills/my-skill/
에이전트를 재시작하세요(또는 새 세션을 시작하세요). 이제 스킬을 사용할 수 있습니다.

폴더 이름이 스킬 이름이 됩니다. review-pr이라는 폴더는 슬래시 커맨드를 지원하는 에이전트에서 /review-pr 커맨드가 됩니다.

어디에 저장할까요? 아래의 에이전트별 가이드에서 사용하는 도구의 정확한 디렉토리 경로를 확인하세요. 간단히 말하면: 대부분의 에이전트는 프로젝트 루트의 .{agent}/skills/{name}/SKILL.md를 사용합니다.

CLI로 빠른 설치

GitHub 리포지토리에서 스킬을 설치하는 가장 빠른 방법:

# Install from mdskills.ai

npx mdskills install <skill-name>

# Or use the Vercel CLI

npx skills add <owner>/<repo>

# Or install manually — just clone and copy

git clone https://github.com/owner/skills-repo.git

cp -r skills-repo/my-skill .claude/skills/

CLI 도구가 설치된 에이전트를 감지하고 스킬을 올바른 디렉토리에 자동으로 배치합니다. 하지만 CLI가 필수는 아닙니다 — 수동으로 폴더를 복사해도 동일하게 동작합니다.

에이전트별 설정

Claude Code

문서

프로젝트:.claude/skills/<skill-name>/SKILL.md

개인:~/.claude/skills/<skill-name>/SKILL.md

Claude Code는 가장 깊은 수준의 스킬 지원을 제공합니다. 스킬은 슬래시 커맨드로 표시됩니다 — review-pr이라는 이름의 스킬은 /review-pr이 됩니다. Claude는 요청이 스킬의 설명과 일치하면 자동으로 스킬을 로드하기도 합니다.

.claude/commands/에 기존 파일이 있다면 그대로 동작합니다. 스킬은 번들 스크립트와 프론트매터 설정 같은 추가 기능을 지원하는 새로운 포맷입니다.

Claude Code는 여러 스킬을 MCP 서버 및 기타 확장 기능과 함께 번들할 수 있는 플러그인도 지원합니다. CLI에서 /plugins를 통해 플러그인을 설치하세요.

Cursor

문서

프로젝트:.cursor/skills/<skill-name>/SKILL.md

개인:~/.cursor/skills/<skill-name>/SKILL.md

Cursor는 2026년 2월에 플러그인 시스템의 일부로 스킬을 지원하는 마켓플레이스를 출시했습니다. 스킬은 MCP 서버, 서브에이전트, 훅, 규칙과 함께 5가지 플러그인 프리미티브 중 하나입니다.

.agents/skills/에 스킬을 배치할 수도 있습니다 — 이 경로는 여러 에이전트가 인식하므로 팀이 다양한 도구를 사용할 때 좋은 선택입니다.

VS Code (Copilot)

문서

프로젝트:.github/skills/<skill-name>/SKILL.md

개인:~/.copilot/skills/<skill-name>/SKILL.md

VS Code는 GitHub Copilot을 통해 에이전트 스킬을 지원합니다. 프로젝트 스킬은 .github/skills/에 위치하므로 코드와 함께 버전 관리에 자동으로 추적됩니다.

VS Code는 .claude/skills/ 및 .agents/skills/도 인식합니다. chat.agentSkillsLocations 설정으로 추가 검색 경로를 구성할 수 있습니다.

Copilot 채팅에서 /를 입력하면 사용 가능한 스킬을 확인하고 직접 실행할 수 있습니다.

OpenAI Codex

문서

프로젝트:.agents/skills/<skill-name>/SKILL.md

개인:~/.agents/skills/<skill-name>/SKILL.md

Codex는 기본적으로 .agents/skills/ 디렉토리를 사용합니다. 이는 여러 에이전트가 인식하는 벤더 중립적 경로로, 다양한 도구에서 동작해야 하는 스킬을 게시할 때 안전한 선택입니다.

Gemini CLI

문서

프로젝트:.gemini/skills/<skill-name>/SKILL.md

개인:~/.gemini/skills/<skill-name>/SKILL.md

Gemini CLI도 폴백으로 .agents/skills/를 읽습니다. Gemini CLI를 특별히 타겟팅하는 경우 .gemini/skills/ 경로를 사용하세요. 크로스 에이전트 호환성을 위해서는 .agents/skills/를 사용하세요.

크로스 에이전트 호환성

스킬을 게시하면서 모든 곳에서 동작하게 하려면 .agents/skills/ 경로를 사용하세요. 대부분의 에이전트가 이 디렉토리를 폴백으로 확인합니다. 팀 전체가 같은 도구를 사용하는 프로젝트별 스킬의 경우, 벤더별 경로를 사용하세요.

팁: 동일한 스킬을 여러 디렉토리에 둘 수 있습니다. 일부 팀은 누가 어떤 에이전트를 사용하든 동작하도록 스킬을 여러 경로에 심볼릭 링크합니다. 간단한 ln -s로 해결됩니다.

설치 확인

스킬을 설치한 후, 에이전트가 인식하는지 확인하세요:

Claude Code: "사용 가능한 스킬이 뭐야?"라고 물어보거나 /를 입력하여 자동완성 메뉴에서 스킬을 확인하세요.
VS Code: Copilot 채팅 창에서 /를 입력하세요.
모든 에이전트: "[작업]에 대한 스킬이 있어?"라고 물어보고 설명을 인식하는지 확인하세요.

스킬이 표시되지 않으면, 폴더 구조를 다시 확인하세요. 디렉토리 안에 SKILL.md 파일이 있어야 합니다 (대소문자 구분).

설치할 스킬 탐색 →직접 만들기 →모범 사례 →