CLOUD SECURITY LAB

🔧 HashiCorp 公式 Agent Skills — Claude Code & Antigravity で Terraform・Packer AI を使う方法

—

by

cslab
in

2026年の今、AIがHCLを正しく理解するためには「公式教科書」が必要です。

HashiCorpが直接開発したAgent Skillsがまさにそれです。

>

🎯 この記事で扱うこと

  • HashiCorp Agent Skillsがなぜ生まれたのか、MCPと何が違うのか
  • Claude CodeとAntigravityにインストールする2つの方法
  • 含まれるSkillsのリストとそれぞれの用途
  • Terraform MCP Serverと一緒に使う方法
  • 実際にどのように動作するかを確認する方法

📌 背景 — AIがTerraform HCLを「間違える」理由

ClaudeやGPTにTerraformコードを作成してもらうと…ほとんどの場合、動作はします。しかし、問題があります。

学習データが古かったり、HashiCorpの内部スタイルガイドを知らなかったり、Providerの最新スキーマを知らなかったりします。そのため、非推奨の属性を使用したり、HashiCorpが推奨しないパターンでコードを作成してしまったりします。

HashiCorp Agent Skillsは、この問題を解決するために登場しました。これは、AIアシスタントが複雑なタスクを信頼性高く実行するために必要な特定の技術的コンテキストが不足しているという根本的な問題を解決する、オープンフォーマットベースのドメイン専門知識パッケージです。

初回リリース時には、TerraformとPacker用のSkillsが含まれており、プラグインフレームワークアーキテクチャ、スキーマ定義、最新のベストプラクティスなどの専門知識をAIアシスタントに提供します。

🔍 Agent Skills vs MCP — 何が違うのか？

混同しやすい2つの概念ですが、役割は全く異なります。

MCPはデータをAIに接続する「パイプ」またはサーバーインターフェースであり、Agent Skillsは知識の「教科書」です。両者は相互補完的であり、一緒に使用することで強力でコンテキスト認識に優れたアシスタントを作成できます。

Claude Skillsは、MCPサーバーを実行したり、カスタムツールを構築したりするオーバーヘッドなしに、構造化された反復可能なワークフローを提供します。

まとめると以下のようになります：
区分 Agent Skills Terraform MCP Server
役割 AIに「知識」を注入 AIがRegistry APIをリアルタイムで呼び出し
実行方式 SKILL.mdファイルをロード 別途サーバープロセスを実行
必要インフラ なし（ファイルのみ） Dockerまたはローカルサーバー
主な用途 スタイルガイド、パターン、アーキテクチャ 最新のProviderドキュメント、Registry検索

—

💻 インストール方法 — Claude Code 基準

方法 1: npx skills コマンドでインストール (推奨)

利用可能なSkillsの全リストを確認し、特定のSkillをインストールする方法は以下の通りです。

# インストール可能なSkillsリストを確認
npx skills add hashicorp/agent-skills --list

# 全てのHashiCorp Skillsを一度にインストール
npx skills add hashicorp/agent-skills

# 特定のSkillのみをインストール（例：Terraformスタイルガイド）
npx skills add hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide

インストール場所は自動的に ~/.claude/skills/ ディレクトリになります。Claude Codeは再起動なしで即座に認識します。

方法 2: Claude Code プラグインマーケットプレイスを利用

Claude Code プラグインマーケットプレイスを通じたインストール方法もサポートしています。

# HashiCorpマーケットプレイスを追加
claude plugin marketplace add hashicorp/agent-skills

# 個別プラグインをインストール
claude plugin install terraform-code-generation@hashicorp
claude plugin install terraform-module-generation@hashicorp
claude plugin install terraform-provider-development@hashicorp

Antigravity でインストールする方法

Antigravity IDEは以下のコマンドでSkillsをインストールします。

# Antigravity専用フラグを使用
npx antigravity-awesome-skills --antigravity

# HashiCorp Skillsのみを選択してインストール
npx skills add hashicorp/agent-skills -a antigravity

または、手動で ~/.gemini/antigravity/skills/ ディレクトリにSkillsフォルダをコピーしても構いません。

📦 含まれるSkillsのリスト

初期のHashiCorp Agent Skillsパックは、TerraformとPackerのユーザーが直面する最も一般的な課題に対応します。

現在提供されている主要なSkills：

Terraform関連

  • terraform-code-generation — HCLコード生成時のHashiCorpスタイル規約の遵守
  • terraform-module-generation — 再利用可能なモジュール構造の生成
  • terraform-provider-development — 新しいProviderの開発（プラグインフレームワークベース）
  • terraform-style-guide — 命名規則、ファイル構造、フォーマットガイド

Packer関連

  • packer-template-generation — PackerテンプレートおよびHCL2構成の生成

🔗 Terraform MCP Server と一緒に使う

Skills（知識）とMCP Server（リアルタイムデータ）を一緒に使うと、さらに強力になります。

Terraform MCP Serverは、AIモデルがTerraform Registryの最新のProviderドキュメント、モジュール、ポリシーにリアルタイムでアクセスできるようにします。これにより、AIは潜在的に古い学習データではなく、正確で最新の情報を使用してTerraform構成を生成できます。

Claude CodeにMCP Serverを追加する方法：

# DockerでMCP Serverを実行
docker run -i --rm hashicorp/terraform-mcp-server:0.2.3

# Claude Codeに登録
claude mcp add --transport http terraform http://localhost:8080/mcp

HCP Terraform Enterpriseを使用している場合は、認証も追加します：

# ~/.gemini/.envファイルに設定
TFE_ADDRESS=your_tfe_address_here
TFE_TOKEN=your_tfe_token_here

⚠️ これだけは注意してください

Skillsの説明(description)がトリガーの精度を決定します。 Skillのdescriptionフィールドが重要です。曖昧な説明は不安定にアクティブ化され、明確なトリガーフレーズを含む説明は一貫してアクティブ化されます。Skillsをカスタマイズする際は、descriptionの記述を具体的に行ってください。

MCP Serverはローカル専用で運用してください。 セキュリティ上の理由から、MCP Serverは現在ローカル使用専用に設計されています。資格情報をコードにハードコーディングせず、環境変数で管理してください。

Skillsと既存のCLAUDE.mdは共存します。 プロジェクトルートのCLAUDE.mdや.claude/commands/のコマンドはそのまま維持されます。Skillsは追加されるものであり、既存の設定を上書きすることはありません。

✅ まとめ

HashiCorp Agent Skillsは「AIがTerraformを正しく理解するための公式教科書」です。Claude CodeとAntigravityの両方で、npx skills add hashicorp/agent-skills の一行でインストール可能であり、Terraform MCP Serverと併用することで、知識（Skills）とリアルタイムのRegistryデータ（MCP）の組み合わせにより、はるかに正確なHCLコードを生成できます。

次のステップとして、Terraform Provider開発を自動化したり、Packer AMIビルドワークフローにAIを組み込みたい場合は、各Skillの詳細ガイドを参照してください： github.com/hashicorp/agent-skills

Comments

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です