Docker Skills 설치

Docker Skills 설치 (Install Docker Skills)

에이전트·조직이 관리하는 방법으로 Docker Skills를 설치하는 방법을 알아볼게요.

출처: 문서

본문

에이전트나 조직이 관리하는 설치 방법을 선택하세요. 네이티브 플러그인, Gemini CLI 확장, 크로스 클라이언트 skills CLI는 별도의 옵션이에요. skills CLI는 사전 요구 사항이 아니에요.

Claude Code {#claude-code}

Claude Code에서 Docker의 마켓플레이스를 추가한 다음 플러그인을 설치하세요:

/plugin marketplace add docker/skills
/plugin install docker-skills@docker

마켓플레이스 설정은 Claude Code의 플러그인 문서를 참고하세요.

GitHub Copilot CLI {#github-copilot-cli}

GitHub Copilot CLI에서 Docker의 마켓플레이스를 추가한 다음 플러그인을 설치하세요:

$ copilot plugin marketplace add docker/skills
$ copilot plugin install docker-skills@docker

마켓플레이스 설정은 Copilot CLI의 플러그인 문서를 참고하세요.

Cursor {#cursor}

Cursor에서 저장소 기반 마켓플레이스는 Teams 또는 Enterprise 플랜과 팀 마켓플레이스를 추가할 권한이 있는 사람(Enterprise의 관리자)이 필요해요. 그 사람에게 Dashboard → Plugins & MCPs → Team Marketplaces → Add Marketplace를 열고, Import from Repo를 선택하고, https://github.com/docker/skills를 입력하고, Docker 플러그인을 마켓플레이스에 추가하고, 접근 설정을 저장하라고 하세요. 마켓플레이스가 사용 가능해지면 Customize를 열고 docker-skills를 찾아 Install을 선택하고 프로젝트 또는 사용자 스코프를 고르세요. 팀이 마켓플레이스를 가져올 수 없으면 skills CLI를 사용하세요. 마켓플레이스 권한과 설치 방식은 Cursor의 플러그인 지침을 참고하세요.

Codex {#codex}

Codex CLI에서 Docker의 저장소를 플러그인 마켓플레이스로 추가하세요:

$ codex plugin marketplace add docker/skills

Codex CLI에서 /plugins를 입력하고 Docker 마켓플레이스에서 docker-skills 플러그인을 찾아 플러그인 브라우저로 설치하세요. 스킬을 사용하려면 새 세션을 시작하세요. 플러그인은 Codex CLI와 ChatGPT 데스크톱 앱에서 사용할 수 있고, Codex IDE 확장에서는 사용할 수 없어요. 클라이언트에서 플러그인을 사용할 수 없으면 skills CLI를 사용하세요. Codex 플러그인 지침과 마켓플레이스 설정을 참고하세요.

Gemini CLI {#gemini-cli}

저장소를 Gemini CLI 확장으로 설치하세요:

$ gemini extensions install https://github.com/docker/skills

확장 구성은 Gemini CLI 확장 문서를 참고하세요.

Google Antigravity {#google-antigravity}

Antigravity는 워크스페이스의 .agents/skills/에서 표준 SKILL.md 디렉터리를 읽어요. 프로젝트 디렉터리에서 skills CLI를 사용해 Antigravity와 필요한 스킬을 선택하세요:

$ npx skills add docker/skills --agent antigravity

또는 검토된 Docker Skills 태그를 클론하고 skills/ 폴더에서 선택한 각 디렉터리를 <workspace-root>/.agents/skills/<skill-folder>/로 복사하되 SKILL.md와 지원 파일을 함께 유지하세요. 다른 발견 위치는 Google의 Antigravity 에이전트 스킬 문서를 참고하세요. Gemini CLI 확장은 Antigravity 플러그인이 아니라 별도의 설치 방법이에요.

skills CLI로 지원되는 다른 에이전트 {#skills-cli}

프로젝트 디렉터리에서 대화형 설치 프로그램을 실행하세요:

$ npx skills add docker/skills

프롬프트가 나타나면 지원되는 에이전트와 필요한 스킬을 선택하세요. 기본 설치는 프로젝트 스코프예요. 사용자 스코프는 --global을 사용하세요. 지원 에이전트와 옵션은 skills CLI 문서를 참고하세요.

Docker Sandboxes {#docker-sandboxes}

[!NOTE] sbx skills 설치 프로그램은 실험적이며 변경되거나 제거될 수 있어요. 자동화하기 전에 설치된 릴리스에서 sbx skills --help를 확인하세요.

저장소에서 공유 샌드박스 스킬 저장소로 설치하세요:

$ sbx skills add docker/skills

공유 저장소 관리, 마운트 동작, 호스트 가져오기는 에이전트 스킬 공유를 참고하세요.

Docker Agent {#docker-agent}

Docker Agent는 문서화된 발견 경로에 설치된 스킬을 사용해요. 설치하거나 업데이트하지 않아요. skills CLI로 설치하거나 선택한 스킬을 복사해 그 경로 중 하나에 두고 agent.yaml에서 선택하세요:

agents:
  root:
    model: dmr/ai/qwen3
    instruction: Help with Docker development tasks.
    skills: true
    toolsets:
      - type: filesystem

skills: true는 발견된 모든 스킬을 포함해요. 스킬 이름 목록으로 선택을 제한할 수 있어요. 경로와 구성은 Docker Agent 스킬 발견을 참고하세요.

Git 클론 또는 수동 복사 {#git-clone-or-manual-copy}

관리 설치 프로그램이 여러분의 클라이언트에 맞지 않으면 Docker Skills의 검토된 태그 달린 개정판을 선택하고 vX.Y.Z를 그 태그로 바꾸세요:

$ git clone --branch vX.Y.Z --depth 1 https://github.com/docker/skills.git

skills/ 아래의 선택한 각 디렉터리를 에이전트가 문서화한 발견 경로로 복사하세요. SKILL.md와 모든 지원 파일을 함께 유지하세요.

설치 검증 (Verify the installation)

먼저 설치된 플러그인 또는 확장 보기, npx skills list, 또는 상황에 맞는 sbx skills ls를 확인하세요. 수동 복사라면 대상에 읽을 수 있는 SKILL.md와 지원 파일이 있는지 확인하세요. 이는 파일이 설치되었다는 것을 확인하지, 에이전트가 스킬을 로드했다는 것은 확인하지 않아요.

새 에이전트 세션을 시작하고 매칭되는 Docker 작업을 요청하세요. 예: "내 Dockerfile을 캐시 효율과 non-root 실행에 맞게 검토해 줘. 어떤 설치된 스킬을 로드했는지 말해 주고 SKILL.md 경로를 보여줘." 클라이언트가 스킬 활동을 표시하면 예상 파일을 로드했는지 확인하세요. 그렇지 않으면 그 파일의 특정 지침을 요청하고 설치된 사본과 비교하세요. 스킬을 사용할 수 없으면 설치 경로와 스코프를 확인하세요.

업데이트 및 문제 해결 (Update and troubleshoot)

네이티브 플러그인과 확장은 해당 클라이언트로, CLI 관리 스킬은 매칭되는 스코프에서 npx skills update(사용자 스코프는 --global 추가)로, 저장소 설치된 샌드박스 스킬은 사용 가능할 때 sbx skills update로 업데이트하세요. 호스트에서 가져온 샌드박스 스킬은 호스트 파일을 업데이트하고 sbx skills import를 다시 실행한 다음 샌드박스를 재시작하세요. Docker Agent는 발견된 파일을 소유한 설치 프로그램에 의존해요.
고정 스냅샷에는 Docker Skills 태그를 선택하고 롤링 저장소 URL 대신 그 태그가 달린 개정판을 사용하세요. 수동 복사된 디렉터리는 자체적으로 업데이트되지 않으므로 다른 검토된 태그로 이동할 때 전체 디렉터리를 교체하세요.
플러그인이나 확장이 나타나지 않으면 의도한 스코프에서 활성화되어 있고 조직이 저장소를 허용하는지 확인하세요.
에이전트가 설치된 스킬을 찾지 못하면 발견 경로와 선택된 에이전트·스코프를 확인하고 새 세션을 시작하세요. Docker Agent는 skills: 필터를, Sandboxes는 공유 저장소가 마운트되고 스킬이 추가되거나 가져왔는지 확인하세요.
링크가 따라지지 않거나 지원 파일이 없으면 완전한 스킬 디렉터리의 물리적 사본으로 다시 설치하세요.

Docker Skills 설치