てくなべ

ansible / network automation / 学習メモ / 思考メモ

[Ansible] Ansible 向けに参考になる Agent Skills やカスタム指示ファイル

はじめに

Ansible の Playbook 作成に携わっている方の中には、Playbook 生成やコードレビューなどで生成AIを活用されている、または活用を予定されている方も多いのではないでしょうか。

私自身も探っている最中です。ただ、カスタム指示ファイルも Agent Skills も、自由度が高くてなかなかとっかかりがつかみにくいのが正直なところです。

ありがたいことに、すでに参考になりそうなものが GitHub リポジトリ上で公開されているので、見つけたものをまとめます。個人リポジトリを含めるとたくさんあると思うのですが、ここでは組織リポジトリ配下のものに絞ります。

中身は英語ではありますが、用途、観点、粒度などの点において参考になりそうです。

なお本記事は、自分で Agent Skills などを書く場合の参考にするためという趣旨で紹介します。(もちろんそのまま利用するのも一手です。そのまま利用する方法については、もしあとで別記事で書いたらリンクを追加しておきます)

主に VS Code 上の GitHub Copilot を前提に説明します。

Agent Skills と Commands

ansible-community/ai-forge

Ansible Forum で案内があったのですが、ansible-community という組織内に ai-forge というリポジトリがあります。ここに Ansible 向けの Agent Skills と Commands が載っています。

github.com

※注意点として、新しいリポジトリなので頻繁に変更が起こり得ることと、人間のレビューが必要であることがREADME.mdに書かれています。本記事では 2026/07/17 のコミット 40367777c1a3cbc983d9ee761f993ccba89aaa7e 時点を前提にします。

本リポジトリを探るには少し前提が必要です。

本リポジトリの Agent Skills や Commands は、Lola という "AI Context Package Manager" によってインストールできるようになっています。その関係で、Agent Skills や Commands が Module という単位で管理されています(Ansible 用語のモジュールとは異なるので 以降 Lola Module と表記)。

リポジトリのトップに Lola Module 単位でディレクトリが並んでいます。そのディレクトリ配下に Agent Skills や Commands が含まれているという構造です。Lola Module によっては、Agent Skills だけだったり、Commands だけだったりすることもあります。

例えば、Lola Module ansible-collection-standards の場合は以下のようになっています。

ansible-collection-standards  # Lola Module トップのディレクトリ
    module
        commands  # Commands のとりまとめディレクトリ
             ansible-collection-inclusion-review.md
             ansible-cop-review.md
             ansible-scaffold-collection.md
        skills  # スキルのとりまとめディレクトリ
             ansible-zen  # スキル ansible-zen のディレクトリ

ここまで本リポジトリにあわせて Commands という表現をしましたが、GitHub Copilot 環境においては Commands はプロンプトファイルと解釈して良さそうです。

実際に Lola (Version 0.7.0)を使って Lola Module を GitHub Copilot 環境向けにインストール(lola install ansible-collection-standards -a copilot-vscode)すると、 Commands は .github/prompts ディレクトリ配下に *.md ファイルが配置されました。例えば ansible-collection-standards/module/commands/ansible-cop-review.md は、.github/prompts/ansible-cop-review.prompt.md (ファイル名に .prompt が差し込まれた)に置かれました。

Lola は、Agent Skills などを各 AI アシスタント(Lola としては GitHub Copilot や Claude Code などを指す)共通のものとしてパッケージで管理しつつ、 各 AI アシスタントの仕様に合わせてインストールするというのが特徴のようです。

以下、いくつか Agent Skills と Commands を紹介します。

所属 Lola Module 名 分類 名前 概要
ansible-collection-standards Commands ansible-cop-review Red Hat Community of Practice 作成の Good Practices for Ansible に基づくレビュー
ansible-content-development Agent Skills write-content Ansible content (Playbook、変数ファイル、インベントリなど)の作成や改善
ansible-documentation Agent Skills ansible-markdown-docs docs.ansible.com から Ansible のドキュメントを Markdown 形式で取得する(この中身を見たことをきっかけで Markdown 形式で取得できることを知りました)

そのまま利用する場合は Lola を使うと簡単に導入できそうです。

カスタム指示ファイル

Awesome GitHub Copilot

github 組織配下でコミュニティベースで運営されている Awesome GitHub Copilot に、Ansible 向けのカスタム指示ファイルが載っています。

awesome-copilot.github.com

中身は以下のファイルです。

github.com

書かれているのは例えば以下の内容です。

  • name を指定する
  • FQCN で指定する
  • インデントは2つのスペース
  • 変数名はスネークケース

人が確認するにも十分現実的なボリュームでまとまっています。

VS Code の Ansible 用拡張内の MCP Server が参照するリソース

VS Code の Ansible 用拡張には、MCP Server が含まれています。

どういう仕組みなんだろうと気になって調べていたときに、Resource として定義されているらしきファイルを見つけました。こちらも参考になりそうです。

github.com

この拡張内の MCP Server を利用するのは結構手軽なので、もし別途記事を書いたらリンクを追加しておきます。

ちなみに、拡張内に MCP Server が含まれることは、2025年の Ansible アドベントカレンダーの記事で知りました。ありがとうございました。

おわりに

改めて一通り眺めてみると、やっぱりいろんな書きっぷりがあって、唯一の正解を探すというのは難しい気もしています。

既存のものをありがたく参考にしつつ自前で書いて改善していくのもよいでしょうし、そのまま使ってみるのも良いかもしれません。

おまけ

Ansible ではありませんが、Red Hat 社提供の Agent Skills がいくつかあるので、ここに Ansible 向けのものも載らないかなぁと妄想しています。

catalog.redhat.com

Terraform だと、hashicorp/agent-skills があるみたいですね。