Docker가 AI 코딩 에이전트의 출력을 향상시키기 위해 지식 스킬(knowledge skills)을 개발했습니다. 이 스킬들은 포터블하며 표준 경로를 통해 모든 규격 준수 에이전트에 의해 자동으로 발견됩니다. 이를 통해 컨테이너화, 이미지 빌드 등 Docker 관련 작업을 체계적으로 수행할 수 있도록 가이드합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기CI
Agent Skills
License
skills.sh
OpenSSF Scorecard
Release
Docker가 작성한 지식 스킬(knowledge skills)로, Docker 관련 작업을 위한 AI 코딩 에이전트의 출력을 향상시킵니다. 이 스킬들은 포터블한 SKILL.md 디렉토리로 한 번 작성되며, 표준 스킬 경로를 통해 모든 규격 준수(compliant) 에이전트에 의해 자동으로 발견됩니다.
아래 설치 단계는 독립적이며, 카탈로그로 생성된 인벤토리에는 각 배포 표면(distribution surface)에 대한 Docker Docs 가이드도 기록됩니다.
스킬은 커버하는 Docker 제품별로 그룹화되어 있습니다. 이 표는 task catalog을 통해 catalog.yaml에서 생성됩니다. 따라서 테이블이 아닌 카탈로그를 수정하십시오.
| 제품 (Product) | 설명 (Description) | 스킬 (Skills) |
|---|---|---|
| Dockerfile & Build<br>source | 프로젝트를 컨테이너화하고 Dockerfile 및 이미지를 작성, 최적화, 강화합니다. | docker-project-foundations — Docker화된 프로젝트 초기화 및 구조화에 대한 가이드.<br>docker-build-strategies — 효율적이고 안전하며 최적화된 Docker 이미지 빌드를 위한 전략. |
| ... | <!-- catalog-end --> |
각 스킬은 자체 설명에서 직접 트리거됩니다. 먼저 로드해야 하는 진입점(entry-point) 스킬은 없습니다.
작업이 여러 스킬에 걸쳐 수행될 때는, 출력 결과가 서로 연결되는 순서대로 스킬을 로드해야 합니다. 예를 들어, 프로젝트에 아직 Docker 설정이 없는 경우에는 docker-project-foundations를 먼저 로드하고 그 다음에 docker-build-strategies 또는 docker-compose-patterns를 로드합니다. 또한, Dockerfile과 compose.yaml 둘 다 변경된 경우에는 docker-build-strategies를 먼저 로드하고 그다음 docker-compose-patterns를 로드해야 합니다. docker-sandboxes-lifecycle는 docker-sandboxes-network-credentials보다 먼저 로드하며, 이 두 스킬은 다시 docker-sandboxes-env 또는 docker-sandboxes-kits보다 먼저 로드합니다. 마지막으로, docker-agent-config를 가장 먼저 로드하고 그다음 docker-agent-run, 그리고 마지막으로 docker-agent-deploy 순서로 로드해야 합니다.
*실험적(experimental)*으로 표시된 스킬은 아직 스키마가 변경될 수 있는 기능을 다룹니다.
skills CLIskills CLI는 모든 주요 코딩 에이전트(Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf, Cline, Kiro 등)에 설치됩니다. 이 스킬은 저장소 내의 skills.sh.json 인덱스를 읽기 때문에, 스킬들은 제품별로 그룹화되어 나열됩니다:
npx skills add docker/skills
이 명령어는 어떤 스킬과 어떤 에이전트를 설치할지 사용자에게 프롬프트를 요청합니다. 비대화형(Non-interactive) 방식:
# 아무것도 설치하지 않고 카탈로그를 탐색
npx skills add docker/skills --list
...
플러그인 설치는 각 에이전트의 마켓플레이스에서 관리되므로, 업데이트는 npx skills update를 통해서가 아니라 해당 에이전트를 통해 이루어집니다. 플러그인 및 확장 기능 설치는 또한 docker-docs에 의해 사용되는 원격 Docker 문서 MCP 서버(https://ai-backend-service.docker.com/mcp)도 등록합니다. 스킬 CLI, Docker Sandboxes, 그리고 수동 복사본은 스킬만 설치합니다.
Claude Code (Claude Code 프롬프트에서 실행):
/plugin marketplace add docker/skills
/plugin install docker-skills@docker
OpenAI Codex
codex plugin marketplace add docker/skills
codex plugin add docker-skills@docker
설치 후 새로운 Codex 세션을 시작하세요. [Codex skills docs] 참조
GitHub Copilot CLI (Copilot CLI 프롬프트에서 실행):
/plugin marketplace add docker/skills
/plugin install docker-skills@docker
[Copilot CLI plugins docs] 참조
Gemini CLI
gemini extensions install https://github.com/docker/skills
설치된 스킬을 발견하려면 Gemini CLI를 재시작하세요. [Gemini CLI extensions docs] 참조
Cursor
사용 가능한 경우 Cursor의 마켓플레이스에서 docker-skills 플러그인을 선택하거나, 위에서 설명한 skills CLI를 --agent cursor와 함께 사용하세요. 팀 마켓플레이스에 저장소를 가져오려면 팀 관리자 권한이 필요합니다. [Cursor plugins docs] 참조
Docker Sandboxes는 또한 독립형 sbx CLI를 통해 실험적인 제품 네이티브 설치를 제공합니다:
sbx skills add docker/skills --skill docker-compose-patterns
sbx skills ls
sbx skills update
모든 스킬을 설치하려면 --skill을 생략하세요. 공유된 스킬 저장소는 설치된 스킬을 다음 시작 시 샌드박스에서 사용할 수 있게 합니다. 이 실험적인 인터페이스가 변경될 수 있으므로 sbx skills --help를 확인하세요. 자세한 내용은 [Docker Docs installation guide]를 참조하세요.
검토된 스냅샷을 사용하려면 Docker Skills releases에서 태그를 선택하고 아래의 vX.Y.Z를 교체하십시오. 별도의 디렉토리에 클론한 다음, 해당 디렉토리의 skills/ 폴더에 있는 전체 스킬 폴더들을 표의 적절한 에이전트 경로로 복사합니다. 또는, 클론된 저장소 자체가 프로젝트 루트인 경우, 검색 심볼릭 링크(discovery symlinks)를 통해 지원되는 에이전트들이 복사 없이 스킬을 찾을 수 있습니다. (단, 프로젝트 하위 디렉토리에 클론하는 것은 검색 경로가 아닙니다.) 수동으로 복사한 경우는 관리형 업데이트 기능이 없으므로, 업데이트 시에는 전체 폴더를 교체해야 합니다.
git clone --branch vX.Y.Z --depth 1 https://github.com/docker/skills.git docker-skills
# 예시: Claude Code용 스킬 하나 설치 (필요에 따라 표의 다른 경로를 사용하십시오)
...
| 에이전트 | 스킬 디렉토리 | 문서(Docs) |
|---|---|---|
| Claude Code | ~/.claude/skills/ | docs |
| ... | ||
Google Antigravity는 skills CLI (--agent antigravity) 또는 수동 복사를 사용하며, 전용 플러그인 매니페스트가 없습니다. 자세한 내용은 Docker Docs for Antigravity를 참조하십시오. Docker Agent는 지원되는 프로젝트 또는 사용자 경로에 설치된 스킬을 사용합니다. |
이 인벤토리는 catalog.yaml에서 생성됩니다. 이는 각 표면에 대한 표준 Docker Docs 설치 링크를 기록하며, 위의 지침은 자체 포함형 설치 경로를 제공합니다.
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
main은 롤링(rolling) 개발 채널이며, 여기서 skills CLI 또는 클론/복사본을 통해 설치된 스킬은 업데이트가 병합됨에 따라 새로 고침될 수 있습니다. v0.3.0과 같은 태그는 불변(immutable)의 검토된 스냅샷입니다. 재현 가능한 설치를 위해 릴리스 태그를 고정(pin)하고, 주기적으로 해당 고정을 검토 및 업데이트하십시오. Claude Code와 Codex 플러그인 업데이트는 매니페스트에 렌더링되는 배포 버전(distribution version)에 의해 제한되므로, 이러한 마켓플레이스는 버전이 지정된 릴리스로 진행됩니다. 게시된 태그는 releases를 참조하십시오.
카탈로그화된 모든 스킬은 Agent Skills specification을 따르며, 상위 skills-ref validator를 통과합니다. skill.yaml, agents/openai.yaml과 같은 리포지토리별 파일, 에셋(assets), 체크(checks), 평가 런북(evaluation runbooks) 등은 핵심 사양 외에 배포 및 품질 관례를 추가합니다. 검색 및 설치 지원은 에이전트마다 다르므로, 현재 클라이언트 기능을 확인하려면 Agent Skills client directory를 참조하십시오.
필수 조건: Task 및 Docker.
task # 전체 CI/릴리스 검증 스위트 실행
task validate # 스킬 구조, 프런트매터(frontmatter), 매니페스트 확인; 검증기 테스트 실행
task eval # 정적 에셋 및 검증 스니펫 체크 (실시간 에이전트 평가 아님)
...
외부 검사에는 공개 네트워크 접속이 필요합니다. task links:external은 Markdown 본문과 카탈로그/플러그인 메타데이터를 스캔하며, python3 scripts/check_external_links.py --base <commit>는 병합 기준점(merge base) 이후 추가된 라인에 포함된 URL 발생 횟수(반복되는 URL 포함)를 확인합니다.
CI에서는 이 네트워크 의존적 검사를 결정론적인 task 유효성 검사와 별도로 실행합니다. 풀 리퀘스트는 추가된 라인의 URL 발생 횟수를 확인하는 반면, 주간 스케줄 및 수동 배포(manual dispatch)는 모든 URL을 확인합니다. 이 자문 워크플로우는 초기 출시 기간 동안 병합에 필수적이지 않습니다. 확정된 HTTP 404/410 오류와 누락된 Docker Docs 앵커는 실패로 보고되지만, 카탈로그 배포 버전이 변경된 PR 검사는 해당 버전의 정확한 CHANGELOG.md 비교를 위해 리디렉션되지 않은 404를 보고하며, 릴리스 태그 링크는 게시 전까지 알림(notice)으로 처리됩니다. 전체 스윕 및 기타 모든 깨진 링크는 여전히 실패합니다.
접근 거부(Access denial), 속도 제한(rate limiting), 서버/네트워크 오류, 불확실한 앵커는 경고로 간주됩니다. HTTPS 프록시가 구성된 경우, 검사기는 우회하는 대신 경고를 표시하며, 이러한 경고만으로는 링크 가용성을 확인할 수 없습니다. 리디렉션은 유지 관리자가 이동된 링크를 업데이트할 수 있도록 보고됩니다. 의도적으로 세션에 종속되는 Slack 초대(https://dockr.ly/slack)는 자동화된 검사에서 제외됩니다.
skills/ — 표준 스킬 디렉토리 (SKILL.md + 지원 파일)
.agents/skills — skills/에 대한 심볼릭 링크 (Codex, 크로스-에이전트 규칙)
.claude/skills — skills/에 대한 심볼릭 링크 (Claude Code)
...
기여 프로세스와 DCO 서명 요건은 CONTRIBUTING.md를 참조하십시오. 스킬을 변경할 때는 카탈로그 및 스킬 버전을 동기화 상태로 유지해야 합니다. AGENTS.md에서 저장소 계약(repository contracts)을 요약합니다. 변경 사항을 제출하기 전에 저장소 루트에서 task를 실행하십시오.
이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE를 참조하십시오.