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。