STOP Inc.
受託開発ソリューション事業

AIに「Dockerの作法」を教え込む──Docker公式「Docker Skills」の中身・活用法・導入手順まとめ

#AI #AIエージェント #AIコーディング #Docker #SKILL.md #Skills

「Claude CodeやCopilotにDockerfileを書かせたら、なんだか重たいイメージができた」「rootで動いている」「いつの間にか docker system prune を打たれていた」──AIコーディングエージェントにコンテナまわりを任せたことがある方なら、一度はこんな経験があるのではないでしょうか。

そんな悩みに、Docker社自身が答えを出してきました。2026年9月24日、Dockerは AIコーディングエージェント向けの公式スキル集「Docker Skills」 を公開しました。エージェントに「Dockerのお作法」をあらかじめ渡しておくことで、より良いDockerfileやCompose設定を、より安全に作らせようという取り組みです。

今回は、Docker Skillsの中身、現場での活用アイデア、そしてエージェント別の導入方法をまとめてみます。

Docker Skillsとは？

Docker Skillsは、Dockerが公開しているオープンソースのスキル集です。リポジトリは docker/skills、ライセンスは Apache License 2.0。公式ドキュメント（docs.docker.com/ai/skills）も用意されています。

ここでいう「スキル」とは、最近のAIエージェントで広く採用されている仕組みで、SKILL.md というファイルを含むディレクトリのことです。SKILL.mdには「どんなときに、どう使うか」が書かれていて、必要に応じて参考資料やテンプレートが同梱されます。

大事なのは、ユーザーがスキル名を指定する必要はないという点です。エージェントが依頼内容を見て「これはDockerfileの最適化だから、このスキルを読もう」と自動で判断して読み込みます。タスクが複数のDocker製品にまたがる場合は、複数のスキルを組み合わせて使うこともできます。

対応エージェントは以下のとおりです。

  • Claude Code
  • OpenAI Codex
  • GitHub Copilot（CLI）
  • Cursor
  • Gemini CLI

特定のAIベンダーに縛られず、主要なエージェントでほぼ横断的に使えるのが魅力です。

収録されている11のスキル

公開時点で収録されているスキルは11種類。対象製品ごとに整理すると次のようになります。

Dockerfile・ビルド向け

スキル名役割
docker-project-foundationsプロジェクトのDocker初期構成づくり
docker-build-strategiesイメージの最適化（マルチステージビルド、キャッシュ戦略、非rootユーザーでの実行など）

Docker Compose向け

スキル名役割
docker-compose-patterns複数コンテナー構成の設定パターン

Docker Sandboxes向け

スキル名役割
docker-sandboxes-lifecycleサンドボックスの作成・削除
docker-sandboxes-network-credentialsネットワーク・認証情報の設定
docker-sandboxes-env環境定義（実験段階）
docker-sandboxes-kitsキットの作成（実験段階）

Docker Agent向け

スキル名役割
docker-agent-configエージェント設定ファイルの作成
docker-agent-runローカルでの実行
docker-agent-deployサーバーとしての提供・配布

製品共通

スキル名役割
docker-destructive-guardrails破壊的操作を行う前の確認方針

「ビルドを上手にする」系と、「AIエージェントそのものをDocker上で安全に動かす」系（Sandboxes／Agent）の二本柱になっているのが特徴的です。

注目ポイント：「消す前に確認する」ガードレール

個人的に一番注目したいのが docker-destructive-guardrails です。AIエージェントにDocker操作を任せるうえで一番怖いのは、取り返しのつかない削除。このスキルは、エージェントに「消す前に確認する（confirm-before-destroy）」というルールを守らせるためのものです。

開発時のプルリクエストを見ると、操作を2段階に分けて扱う設計になっています。

  • 低リスク（確認の手間は少なめ）：そのセッション中にエージェント自身がテスト用に作った、特定の1コンテナーだけを削除するケース。停止済み、または自分で起動したもので、保存していない状態が失われる心配がないことが条件です。
  • 高リスク（必ず明示的に確認）：それ以外のすべて。たとえば docker kill（例外なく常にこちら）、実行中コンテナーへの docker rm -f、docker rm -f $(docker ps -aq) のような一括削除、エージェントが作っていないコンテナーへの操作などです。

イメージのprune、ボリュームの削除、system 系のクリーンアップといった操作もカバーされています。「AIが気を利かせて全部掃除してくれた結果、開発用DBのボリュームが消えた」──といった事故を防ぐ、実務的にとてもありがたいスキルです。

活用アイデア

導入したら、あとは普段どおり自然な言葉で頼むだけです。たとえばこんな使い方が考えられます。

1. 既存Dockerfileのダイエット＆セキュリティ強化

「このDockerfileで作るイメージを小さくして、root以外のユーザーで動くようにして」

docker-build-strategies が効いて、マルチステージビルド化、キャッシュが効く命令順への並べ替え、非rootユーザー化などを提案してくれるはずです。

2. 新規プロジェクトのコンテナ化

「このNode.jsアプリをDockerで開発できるようにして。DBはPostgreSQLで」

docker-project-foundations と docker-compose-patterns が組み合わさり、Dockerfileと開発用のcompose.yamlを一式用意する、という流れが期待できます。

3. AIエージェントを隔離環境で動かす

「このリポジトリ用にDocker Sandboxを作って、必要なネットワークと認証だけ許可して」

Sandboxes系スキルを使えば、エージェントの実行環境そのものをコンテナで閉じ込める設定もエージェントに任せられます。社内でAIエージェント活用を進める際の「安全な砂場づくり」に役立ちそうです。

4. チームの標準装備にする スキルはプロジェクト単位でも全体（グローバル）でも導入できます。チーム全員のエージェントが同じ「Dockerの作法」を参照するようにしておけば、人によってDockerfileの書き方がバラバラになる問題も緩和できます。

導入方法

エージェントごとに手順が用意されています。導入後は新しいセッションを開始してから使いましょう。

Claude Code

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

GitHub Copilot CLI

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

OpenAI Codex

docker/skills をマーケットプレイスとして追加し、Codex CLI内のプラグインブラウザーから docker-skills を選んでインストールします。

Cursor

チーム管理者がリポジトリのマーケットプレイスをインポートする必要があります（管理者権限が必要）。取り込まれたあとは、Customizeメニューからインストールできます。

Gemini CLI

拡張機能として直接インストールします。

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

共通の方法：skills CLI

エージェントを問わず使える方法として、skills CLIも利用できます。

npx skills add docker/skills

対話形式で複数のエージェントにまとめて導入でき、--global を付けるとユーザー全体（複数プロジェクト共通）で使えるようになります。

Docker Sandboxes／Docker Agentの中で使う

  • Docker Sandboxes：sbx skills add docker/skills（実験的機能）
  • Docker Agent：agent.yaml に skills: true を設定すると、検出されたスキルがすべて有効になります

動作確認とアップデート

導入後、新しいセッションで「このDockerfileを見直して」などDocker関連の依頼をしてみて、スキルが読み込まれるか確認しましょう。更新は導入方法に応じて、各クライアントのアップデート機能、npx skills update、sbx skills update のいずれかで行います。スキル集は今も活発に改良が続いているので、定期的な更新がおすすめです。

使うときに気をつけたいこと

  • スキルは「ガイド」であって「自動保証」ではない：公式ドキュメントでも、エージェントの提案した変更は人がレビューし、テストを通してから採用するよう明記されています。スキルがあっても最終確認は人の仕事です。
  • まだ全製品を網羅しているわけではない：スキル集は成長途中で、Dockerのすべての製品・機能をカバーしているわけではありません。
  • 実験段階のスキルがある：docker-sandboxes-env と docker-sandboxes-kits、そして sbx skills コマンドは実験的な位置づけです。本番運用に組み込む前に挙動を確認しましょう。
  • Cursorは管理者作業が必要：チームで使う場合は、事前に管理者と導入手順を調整しておく必要があります。

まとめ

Docker Skillsは、「AIにDockerを触らせると、動くけれど“お作法”が微妙」という問題に、Docker公式が正面から取り組んだものです。軽量で安全なイメージの作り方から、AIエージェント自身をコンテナで安全に動かす方法、そして“消しすぎない”ためのガードレールまで、実務で効くポイントがうまく押さえられています。

導入はコマンド1〜2行。まずは手元の古いDockerfileを1つ選んで、「小さく、非rootで」と頼んでみるところから始めてみてはいかがでしょうか。

本記事は、gihyo.jpの記事「Docker、AIコーディングエージェント向けの公式スキル『Docker Skills』を公開」（2026年9月）、Docker公式ドキュメント（docs.docker.com/ai/skills）、GitHubリポジトリ docker/skills の公開情報をもとに整理したものです。スキルの構成や導入手順は今後変わる可能性があります。導入にあたっては最新の公式情報をご確認ください。

関連記事