docker/skills

AI 코딩 에이전트를 위한 Docker Skills

무엇인가 – AI 코딩 어시스턴트(Claude Code, OpenAI Codex, GitHub Copilot, Gemini CLI, Cursor 등)에게 Docker를 다루는 방법을 가르치는 Agent Skills 모음입니다. 각 skill은 자체 SKILL.md 폴더에 있으며, 오픈소스 Agent Skills 사양을 따릅니다.

왜 중요한가 – 이러한 skills를 설치하면 AI 어시스턴트가 Docker에 특화된 구체적인 가드레일, 모범 사례 조언, 명령 템플릿을 얻을 수 있습니다. 이를 통해 모델은 Dockerfile 변경, Compose 파일, 샌드박스 수명 주기 명령 또는 Docker-Agent 구성을 제안하거나 실행할 때 환각이나 안전하지 않은 작업을 훨씬 줄일 수 있습니다.

주요 구성 요소

• Skill 카탈로그 – catalog.yaml은 제품 그룹(Dockerfile & Build, Compose, Sandboxes, Docker Agent, 교차 제품 가드레일)과 개별 skill ID를 정의합니다.
• Skill 디렉터리 – skills/ 아래의 각 폴더(예: docker-compose-patterns)에는 설명, 입력, 출력, 검증 규칙이 담긴 SKILL.md가 있습니다.
• 설치 – skills CLI(npx skills add docker/skills …) 또는 각 지원 에이전트용 네이티브 marketplace 플러그인이 선택한 skills를 에이전트의 skill 디렉터리에 설치합니다. 수동 복사 및 샌드박스 네이티브 옵션도 있습니다.
• 가드레일 – docker-destructive-guardrails skill은 되돌릴 수 없는 Docker 작업 전에 반드시 확인을 요구합니다.
• 실험적 기능 – 일부 샌드박스 관련 skills(docker-sandboxes-env, docker-sandboxes-kits)는 실험적로 표시되어 있으며 변경될 수 있습니다.

사용 방법

1. skills CLI를 실행하거나 에이전트의 marketplace를 통해 설치합니다.
2. 필요한 skill을 선택합니다(예: docker-compose-patterns).
3. 에이전트가 해당 skill을 자동으로 로드하여 상황에 맞는 제안이나 안전한 명령 실행을 제공합니다.

개발 – 이 repo는 CI, 검증, 카탈로그 재생성을 위해 Taskfile.yml을 사용합니다. 기여 시 skill 카탈로그와 버전 번호를 동기화해야 합니다.

라이선스 – Apache 2.0.