Docker Skillsは、AIコーディングエージェントがDockerタスクを実行する際に参照する公式の作業ガイドライン集です。Dockerfileの作成、イメージのビルド、複数のコンテナをComposeで接続する際に必要な手順と例を、エージェントが読み取れる形式で提供します。
AIに「このプロジェクトをコンテナで実行して」と依頼すると、いくつかのファイルを作成することから始められます。ここにビルドキャッシュ、データベースの準備状況、実行権限まで考慮すると、確認すべき項目が増えます。Dockerは、このような反復的な判断を再利用できるように公式Skillsを公開しました。Claude CodeやCodexを含む互換性のあるエージェントで使用できます。Docker公式紹介
この記事では、2026年9月27日に確認した公式ドキュメントとリポジトリを基準に、提供機能、インストール方法、実際に依頼できる作業について考察します。中心となる質問はシンプルです。「Docker Skillsをインストールすると、エージェントにどのような作業をより具体的に任せられるのか？」
1. エージェントがDocker作業の基準を一緒に読み込む
Dockerfileはコンテナイメージを作成する方法を記述したファイルです。Composeはアプリケーション、データベース、キャッシュのように複数のサービスを一緒に実行するための構成を扱います。エージェントが両ファイルの文法を知っていても、プロジェクトごとにどのような構成が適切かは別途判断する必要があります。
例えば、ウェブアプリケーションのイメージを減らすには、コンパイルツールが実行環境にも必要かを確認する必要があります。データベースを追加するなら、接続アドレスだけでなく、データ保存場所と起動条件を定める必要があります。リクエストにこのような条件を毎回長く記述する代わりに、関連する作業ガイドラインをまとめて、必要なときに読み込ませる方式がSkillsです。
Agent Skills形式では、スキルはSKILL.mdを含むフォルダです。このファイルには、名前、適用する状況に関する説明、作業ガイドラインが含まれます。必要に応じて、実行スクリプト、詳細な参考ドキュメント、設定テンプレートも一緒に配置します。したがって、スキルは短いプロンプト一行よりも広い範囲の作業資料を格納できます。Agent Skills概要
エージェントはユーザーのリクエストとスキル説明を比較して、関連するガイドラインを呼び出します。Docker公式ドキュメントも、スキル名を直接言う必要なく、自然言語で希望する結果をリクエストできると案内しています。ただし、実際の発見・呼び出し方法とサポート機能は、使用するクライアントによって異なります。Docker Skillsの動作方式
図1. リクエストに必要なガイドラインを読み込み、作業に適用する流れ。Agent Skills仕様とDocker Skills紹介公式ドキュメントを基に再構成しました。ファイル修正と検証は、Docker開発作業を説明するための例です。
Agent Skills仕様は、名前と説明、全体ガイドライン、追加資料を段階的に読み込む構造を説明します。すべての参考ファイルを最初からすべて含めるのではなく、作業に必要な深さまで資料を読み込む方式です。スキルフォルダを移動する際にSKILL.mdだけをコピーすると、リンクされたテンプレートやスクリプトが欠落する可能性があるため、フォルダ全体を維持する理由もここにあります。Agent Skills仕様
この構造において、Docker Skillsは判断と作業順序を案内します。実際のファイル変更とコマンド実行はエージェントが持つツールと権限内で行われ、イメージビルドとコンテナ実行はDocker環境が担当します。スキルをインストールした後も、Docker実行環境とプロジェクトテストは別途用意する必要があります。
2. 現在どのような作業をサポートしているか？
確認時点の公式カタログには、11個のスキルが登録されています。製品別に分けると以下の通りです。表の名前は、インストールするスキルを選ぶ際に使う識別子です。公式カタログ
一般的なアプリケーション開発であれば、最初の3つのスキルから理解するのが自然です。それぞれ「初めて構成する」「イメージビルドを洗練する」「複数のサービスを接続する」に対応します。
初めてコンテナ化する際：docker-project-foundations
このスキルは、Docker構成がないプロジェクトから出発します。基本的に.dockerignore、Dockerfile、compose.yamlを一緒に作成するように案内します。.dockerignoreは、ビルドに送るファイルから不要な項目を除外する役割を果たします。
開発用データベースやキャッシュもComposeサービスとして構成する方向を提示します。開発者がホストに各サービスを個別にインストールする代わりに、プロジェクト構成内で一緒に実行するようにするものです。ローカル開発ポートとサービス配置に関する基準も含まれます。Project Foundationsスキル
例えば、次のようにリクエストできます。この記事のリクエスト文は活用例であり、実行結果を引用したものではありません。
이 웹 애플리케이션을 로컬에서 Docker Compose로 실행할 수 있게 구성해 줘.
기존 실행 방법과 의존성을 먼저 확인하고,
Dockerfile, compose.yaml, .dockerignore의 변경안을 설명해 줘.
데이터베이스는 개발용으로 사용하며 데이터를 재시작 후에도 유지하고 싶어.ここで望む結果は「Dockerfile生成」よりも具体的です。他の開発者がプロジェクトをダウンロードしたときに、どのような方法で実行するかまで作業範囲に含まれます。
既存イメージを洗練する際：docker-build-strategies
このスキルは、多段階ビルド、キャッシュ活用、ビルド対象ファイル、一般ユーザー実行などを扱います。多段階ビルドは、ビルドツールが必要な段階と最終実行段階を分け、実行に必要な成果物だけを最終イメージに移動する方式です。Build Strategiesスキル、Docker多段階ビルドドキュメント
キャッシュが役立つ場面も考えられます。ソースコード一行だけ変更したのに外部パッケージを毎回再インストールするなら、依存関係のインストール段階がどのようなファイル変更に影響を受けるかを検討する価値があります。Dockerは、依存関係定義ファイルを先にコピーしてインストールした後、頻繁に変わるソースをコピーする方式で、不要なキャッシュ無効化を減らす例を説明しています。Dockerビルドキャッシュ最適化
이 Dockerfile의 빌드 캐시와 최종 이미지 구성을 검토해 줘.
의존성 설치가 다시 실행되는 조건과 실행 이미지에 남는 파일을 설명하고,
동작을 유지하면서 바꿀 수 있는 부분을 제안해 줘.
수정 후에는 기존 테스트와 이미지 실행 확인 방법도 정리해 줘.イメージサイズやビルド時間がどれだけ短縮されるかは、プロジェクトとキャッシュの状態によって異なります。比較する際は、同じコードと実行条件を置き、キャッシュがない最初のビルドとソースだけを変更した再ビルドを分けて記録する方が判断しやすいでしょう。これは導入効果を確認するための測定方法の例です。
サービス接続を洗練する際：docker-compose-patterns
Composeスキルは、サービス間の依存関係、状態検査、ボリューム、ネットワークと開発用設定の分離を扱います。例えば、データベースを接続したウェブサービスで「コンテナはすべて起動したが、アプリが接続エラーを出す」という問題を調査する際に適用できます。
このスキルには、設定を検査する補助スクリプトと点検資料も含まれています。このような資料は、エージェントがファイルを生成する段階で終わらず、結果を確認する手順まで進むのを助けます。Compose Patternsスキル
3. Composeの例：起動したことと準備ができたこと
ウェブアプリケーションがデータベースに接続する必要がある状況を考えます。データベースコンテナが起動した直後には、内部初期化が進行中である可能性があります。その瞬間、ウェブサービスが接続を試みると失敗する可能性があります。
Composeの基本起動順序とサービスの準備状態は、互いに異なる条件です。Docker公式ドキュメントは、healthcheckで準備状態を検査し、依存関係にcondition: service_healthyを指定して、その検査が通過した後に依存サービスを起動する構成を説明しています。Compose起動順序ドキュメント
図2. コンテナ起動と状態検査通過の違い。Docker Compose起動順序公式ドキュメントを基に再構成しました。時間間隔は概念説明用であり、測定値ではありません。
エージェントには次のようにリクエストできます。
Compose로 서비스를 시작할 때 웹 애플리케이션이 가끔 DB 연결에 실패해.
compose.yaml의 의존성과 DB 준비 상태 검사를 확인해 줘.
원인을 설명한 뒤 필요한 healthcheck와 시작 조건을 제안하고,
현재 데이터 볼륨을 유지하면서 검증하는 방법을 알려 줘.この例で重要な成果物は、YAML数行とともに説明される動作条件です。どのような検査でデータベースが準備できたと判断するのか、検査が失敗した場合にウェブサービス起動にどのような影響を与えるのかを知ることで、変更を検討できます。
また、この条件は起動時点の依存関係を扱います。運用中に接続が切断された場合の再接続やアプリケーションレベルのエラー処理は、別途確認すべき項目です。このようにスキルが案内する設定とアプリケーションが処理すべき動作を一緒に見ると、リクエスト範囲と検証範囲が明確になります。
4. インストールは必要なスキルと適用範囲から選ぶ
Dockerは、エージェント別プラグインと拡張、複数のクライアントにインストールできるskills CLI、手動コピーなど、複数の経路を案内しています。ここでは、Claude CodeとCodexでも使用できる共通CLI方式から見ていきます。CLIはターミナルでコマンドとして使用するツールを指します。公式インストール案内
以下のコマンドは、公式案内を基に整理したインストール例です。npxを使用できるNode.js/npm環境と、サポートされるコーディングエージェントが必要です。Docker作業を実際に実行するには、該当作業に合ったDocker・Compose環境も準備されている必要があります。
まず、インストール可能なリストを確認できます。
npx skills add docker/skills --listプロジェクトディレクトリで次のコマンドを実行すると、インストールするスキルと対象エージェントを選択する手順が進行します。
npx skills add docker/skills基本範囲は現在のプロジェクトです。ユーザー範囲インストールは--globalオプションで選択できます。プロジェクト範囲は該当リポジトリで使用する構成を区別するのに適しており、ユーザー範囲は複数のプロジェクトで共通して使いたい場合に合います。同じスキルをどの範囲にインストールしたかを知っておくと、後でアップデートする対象を見つけやすくなります。skills CLIのインストール範囲
特定のスキルをCodexにインストールするように、対象を明示することもできます。以下は、公式READMEのスキル・エージェント選択オプションを組み合わせた例です。
npx skills add docker/skills --skill docker-compose-patterns --agent codexClaude Codeを選択するには、対象オプションを変更します。
npx skills add docker/skills --skill docker-compose-patterns --agent claude-codeサポート対象とオプションは、インストール時点のCLI案内を基準に確認できます。全体リストをまず確認し、必要なスキルから追加する方法も可能です。Docker Skills READMEのインストール例、skills CLIの対象・スキル選択オプション
Claude Codeでは、クライアントのプラグインパスも提供します。Claude Codeプロンプトで次のコマンドを使用します。
/plugin marketplace add docker/skills
/plugin install docker-skills@dockerコマンド実行後、プラグイン詳細画面が開くバージョンでは、インストール範囲を選択し、完了状態を確認します。その後、無効化や削除はClaude Codeのプラグイン管理画面で行うことができます。Claude Codeプラグイン管理ドキュメント
プラグインインストールとCLIインストールは別々の選択肢です。すでに組織で管理するインストール方式がある場合は、その方式に従えば良いでしょう。Codexを含む各クライアントのパスは、Dockerのエージェント別インストールドキュメントにまとめられています。
5. インストール確認と実際の使用確認を分ける
インストールリストに名前が見えることと、エージェントが該当作業でスキルを読み込むことは別々の確認です。CLI方式では、次のコマンドでインストールリストを確認できます。
npx skills list次に、新しいエージェントセッションを開き、Dockerfileレビューのようにスキルに合った作業をリクエストします。使用したスキル名と読み込んだSKILL.mdのパスを一緒に教えてもらうと、適用対象を確認するのに役立ちます。クライアントがスキル使用履歴を表示するならその記録を確認し、そうでなければエージェントが説明したガイドラインをインストールファイルと照合できます。発見されない場合は、インストール対象エージェント、プロジェクト・ユーザー範囲、検索パスを確認します。Dockerのインストール検証手順
作業結果の検証もさらに一段階必要です。例えば、Compose構成を変更した場合は、次のコマンドで構成自体を検査できます。
docker compose config --quiet--quietは、全体構成内容を出力せずに検証するオプションです。この検査が通過すれば、Composeが解釈する構成に対する確認を得られます。実際のイメージビルド、サービス起動、データベース接続と業務機能の正常動作は、別途の実行・テストで確認します。docker compose configドキュメント
レビュー結果を残す際は、「修正した」と「検証した」を具体的な結果に繋げると良いでしょう。変更したファイル、実行した検査、成功の有無、実行できなかった確認項目を一緒に記述する方式です。これはスキル導入後もチームのコードレビューとテスト過程にそのまま繋げることができます。
CLIインストールを元に戻したい場合は、npx skills remove docker-compose-patternsのようにインストールしたスキル名を指定して削除手順を進めることができます。ユーザー範囲にインストールした場合は、それに合った範囲オプションを使用します。skills CLIの削除コマンド
6. 削除ポリシーとアップデートも作業ガイドラインの一部である
Docker作業には、ファイル作成以外にコンテナ停止、イメージ・キャッシュ削除、データボリューム整理も含まれることがあります。公式コレクションには、このような動作を扱うdocker-destructive-guardrailsが別途あります。影響を説明し、確認する基準を提供し、制限されたテストコンテナ整理のように条件を満たす場合も区別します。削除・停止作業ポリシー スキル
Composeに属する削除動作は、Composeスキルが具体的に扱います。例えば、docker compose down -vはプロジェクトが管理する名前付きボリュームなどを削除できるため、データ保存要求とともに検討する必要があります。外部ボリュームのようにComposeが管理しない対象は適用範囲が異なります。このようなガイドラインは、エージェントが「再起動」「問題解決」「データ削除」を区別して作業するように案内します。Composeスキルの削除コマンド説明
このポリシーは、エージェントが読み込む行動ガイドラインです。実際のコマンド実行権限と承認設定は、使用するエージェント・実行環境で定めます。公式スキルを導入する際も、チームのデータ保存ポリシーと作業権限を一緒に適用すると、責任範囲が明確になります。
アップデート経路はインストール方式に合わせます。skills CLIでインストールした場合は、次のコマンドを使用できます。
npx skills updateユーザー範囲でインストールした場合は、その範囲に合わせて--globalを適用します。プラグインと拡張は該当クライアントで管理され、手動でコピーしたフォルダは自動更新されません。Dockerリポジトリのmainは変更が反映される開発チャネルであり、レビューした構成を再現するには、公式リリースタグを選択して使用する方式が提供されています。Docker Skillsリリース案内
チームで導入する場合は、インストール方法、選択したスキル、使用するタグやバージョン、検証する代表プロジェクトを記録しておくことができます。次のバージョンに移行する際に、同じプロジェクトで生成ファイルとテスト結果を比較すると、変更されたガイドラインがチームの作業にどのような影響を与えるかを確認しやすくなります。これはバージョン管理された作業ガイドラインを運用する方法の例です。
7. 公式Skills公開の意味
Docker Skillsは、製品を作成した側が提供する作業ガイドラインをAIコーディングエージェントが使用できる形式で配布した事例です。開発者は希望する結果をリクエストし、エージェントはプロジェクトファイルと関連スキルを一緒に参照して変更を提案したり実行したりします。ガイドラインがGitHubで管理されているため、どのようなルールを参照しているのかも確認できます。
実務では、繰り返し説明していた条件を具体的な検討項目に繋げられる点が有用です。「初めて実行できるように構成する」「ビルドキャッシュを洗練する」「DB準備状態を待つ」のように範囲が明確な作業から適用すると、結果も確認しやすくなります。
効果を判断する基準は、インストールしたスキルの数よりも作業結果です。生成された構成がプロジェクトに合っているか、検証手順を通過するか、レビューと修正にかかる負担が減るかを確認できます。Docker公式Skillsは、このような作業を開始する際に使用できる公開された基準と資料を提供します。
公式リポジトリ：docker/skills ・ 使用案内：Docker Skills ・ インストール案内：Install Docker Skills
コメントを残す