1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@shu_tana(s.tanabe)

Terraform×Claude Code ①(全6回) ｜Skills比較｜4つの公開スキルを調べて分かった最適な組み合わせ

1
Last updated at Posted at 2026-02-24

シリーズ記事一覧

📑 目次

  1. この記事について
  2. この記事のゴール
  3. 前提知識：CLAUDE.mdとSkillsの違い
  4. 調査対象：4つのTerraform Skills
  5. antonbabenko/terraform-skill
  6. hashicorp/agent-skills（公式）
  7. hashi-demo-lab/claude-skill-hcp-terraform
  8. zxkane/aws-skills
  9. 徹底比較表
  10. 最適な組み合わせ
  11. シリーズの全体像
  12. 学習ロードマップ
  13. まとめ

1. この記事について

Claude Codeの Skills という機能をご存知ですか？
Skillsは、Claude Codeに「専門知識」を渡して、
特定のタスクでの品質を劇的に向上させる仕組みです。
2025年後半から急速にコミュニティが拡大し、
Terraform向けだけでも 4つの主要なSkills が公開されています。
まずSkillsの全体像を調査しました。
本記事はその調査結果を 私のような初心者向けに体系化 したものです。

1-1. 対象読者

  • Terraformを使っている（or これから使う）エンジニア
  • Claude Codeに興味がある、もしくは使い始めた方
  • 「Skills」「Agent Teams」という用語は聞いたことがあるが、
    何から始めればいいか分からない方

1-2. 記事のスタンス

筆者はインフラエンジニアとしてTerraformを学習中の立場です。
「プロが教える」ではなく、
「初心者が調べて整理した」という視点で書いています。

2. この記事のゴール

この記事を読み終えたとき、以下の状態になることを目指します。

# ゴール
① CLAUDE.mdとSkillsの違いが説明できる
② Terraform向け4つのSkillsの特徴と違いが分かる
③ 自分に合ったSkillsの組み合わせを選べる
④ インストールして使い始められる
⑤ シリーズ全体の学習パスが見える

3. 前提知識：CLAUDE.mdとSkillsの違い

3-1. 🍽️ レストランで例えると

Skillsを理解するには、
まず CLAUDE.md との役割の違い を知る必要があります。

🍽️
CLAUDE.md = お店のハウスルール（店全体のルール）
  「うちの店は和食です」「接客は丁寧語で」「営業時間は11-22時」

Skills = 各ポジションの専門マニュアル
  寿司職人マニュアル：「シャリの温度は○度」「ネタの切り方は…」
  接客マニュアル：「予約対応の手順」「クレーム対応フロー」
  仕入れマニュアル：「築地の仕入先リスト」「鮮度チェック基準」

ハウスルールは 全員が毎日読む。
でも寿司職人に接客マニュアルは要らない。
必要な人に必要な知識だけ渡す のがSkillsです。

3-2. 技術的な違い

各マニュアル🍣🤝📦が Skills のイメージです。

観点 CLAUDE.md Skills
置き場所 プロジェクトルート or ~/.claude/ .claude/skills/○○/SKILL.md
読み込み 毎回自動で全部読まれる 必要な時だけ読まれる
書く内容 プロジェクト全体のルール・方針 特定タスクの専門知識・基準
肥大化リスク 大きくなると全体の品質が落ちる 分割されているので影響しない
Agent Teams チーム全員に適用 チーム全員に継承される

3-3. Skillsが「必要な時だけ読まれる」仕組み

SKILL.mdの先頭にはYAMLフロントマターがあり、
name と description が記載されています。

---
name: terraform-review
description: Terraformコードのセキュリティ・コストレビュー基準
user-invocable: false
---

🔰Note
user-invocable: false
→ ユーザーが /skill名 で直接呼び出すのではなく、Claude が自動判断で読み込む

Claude Codeはタスクを受け取ると、
まず 全Skillsの description だけ をスキャンします。
「今のタスクに関連ありそうだ」と判断したものだけ、中身を読み込みます。

🍽️
棚に並んだマニュアルの 背表紙のタイトル だけ見て、必要なものを手に取る感じです。

3-4. なぜ分けるのか？

状態 何が起きるか
全部CLAUDE.mdに書く 毎回全文読まれる → トークン消費大 → 関係ない情報がノイズに
CLAUDE.md + Skills 共通ルールだけ毎回読む → 専門知識は必要時だけ → 精度UP

🍽️
「寿司職人に毎朝、接客マニュアルと仕入れマニュアルも全部読ませる」のが前者。
「寿司のことだけ集中してくれ」が後者です。

4. 調査対象：4つのTerraform Skills（①～④）

GitHubで今回調査した4つの公開Skillsを一覧で紹介します。
（Star数は2026年2月時点）

# Skills 作者 Star ライセンス 特徴
① antonbabenko/terraform-skill Anton Babenko（AWS Hero） 831 ⭐ Apache 2.0 最も包括的。
テスト・CI/CD・セキュリティ全部入り
② hashicorp/agent-skills HashiCorp公式 60 ⭐ MPL-2.0 公式スタイルガイド。
将来Vault/Consul拡張予定
③ hashi-demo-lab/claude-skill-hcp-terraform HashiCorpデモラボ — — HCP Terraform特化。
MCP/LSP連携がユニーク
④ zxkane/aws-skills zxkane 33 ⭐ MIT AWS CDK中心。
MCP連携（Pricing/Cost Explorer/CloudWatch）

5. ①antonbabenko/terraform-skill

5-1. 概要

Terraformコミュニティの重鎮、
Anton Babenko氏（AWS Hero、Terraformモジュールのダウンロード数が億単位）が作成したSkillです。
現時点でTerraform向けSkillsの中で 最も包括的かつ成熟度が高い ものです。

5-2. ファイル構成

terraform-skill/
├── SKILL.md                    # コアファイル（~524行、~4,400トークン）
├── references/                 # 詳細ガイド（必要時だけ読まれる）
│   ├── ci-cd-workflows.md      # CI/CDテンプレート（~473行）
│   ├── code-patterns.md        # コードパターン＆最新機能（~859行）
│   ├── module-patterns.md      # モジュールのベストプラクティス（~1,126行）
│   ├── quick-reference.md      # コマンドチートシート（~600行）
│   ├── security-compliance.md  # セキュリティガイド（~470行）
│   └── testing-frameworks.md   # テストガイド（~563行）
├── README.md
├── CLAUDE.md                   # 開発者向け
└── LICENSE

5-3. 「プログレッシブ・ディスクロージャー」設計

このSkillの最大の特徴は、段階的開示 の設計思想です。

🍽️ 比喩でいうと：

SKILL.md（524行）= メニュー表
  → 最初に見るもの。基本ルールと判断基準を掲載。

references/（6ファイル、計~4,000行）= 厨房の詳細レシピ集
  → 注文が入った時だけ該当レシピを開く。
段階 何が読まれるか トークン数
常に SKILL.mdのメタデータ（nameとdescription） ~100
Terraform関連タスク時 SKILL.md本体 ~4,400
詳細が必要な時だけ references/の該当ファイル 必要分だけ
全部合計 ~30,400

もし全部をSKILL.md 1ファイルに入れると 毎回30,000トークン消費。
この構造なら 通常は4,400トークンで済む。
コスト的にも品質的にも賢い設計です。

5-4. SKILL.mdに含まれる内容

カテゴリ 内容
When to Use いつ使うか・使わないかの判断基準
Code Structure ディレクトリ構成、命名規則、ブロック順序
Testing Strategy テスト手法の判断マトリクス（テストピラミッド）
Count vs For_Each 使い分けガイド
Module Development 標準モジュール構成
CI/CD Integration ワークフロー4ステージ
Security & Compliance Trivy/Checkov統合
Version Management バージョン制約戦略
Modern Features Terraform 1.0〜1.11の機能一覧

5-5. 学びポイント：判断マトリクスの設計

特に参考になるのが、テスト戦略の判断マトリクスです。
「何を使うか」ではなく「いつ・なぜ使うか」が表形式で整理されています。

あなたの状況 推奨アプローチ ツール コスト
簡単な構文チェック 静的解析 validate, fmt 無料
コミット前の検証 静的 + lint validate, tflint, trivy 無料
Terraform 1.6以上 ネイティブテスト terraform test 無料〜低
セキュリティ重視 Policy as Code OPA, Sentinel 無料
マルチクラウド・複雑 統合テスト Terratest + 実環境 中〜高

6. ②hashicorp/agent-skills（公式）

6-1. 概要

HashiCorp本体が公式に提供するAgent Skillsです。
Terraform向け3プラグインに加え、Packer向けも含まれています。
将来的にVault（シークレット管理）、
Consul（サービスネットワーキング）などにも拡張予定とされています。

6-2. Terraform向けプラグイン構成

プラグイン 内容
terraform-code-generation HCLコード生成時のスタイルガイド
terraform-module-generation モジュールのリファクタリング・生成
terraform-provider-development Terraformプロバイダーの開発

6-3. 特徴と位置づけ

  • 公式であることの権威性 が最大の強み
  • HashiCorp自身が定めたスタイルガイドに準拠したコード生成ができる
  • ただし、テスト・CI/CD・セキュリティなどはまだカバーされていない
  • antonbabenko/terraform-skill の補完として使うのがベスト

7. ③hashi-demo-lab/claude-skill-hcp-terraform

7-1. 概要

HashiCorpのデモラボチームが公開している、HCP Terraform特化のSkillsです。
5つのスキルで構成されています。

7-2. スキル構成

スキル 内容 ユニークさ
terraform-style-guide コードの書き方ルール集。
Azure 公式モジュール（AVM）の命名規則にも対応		 Azure対応が独自
terraform-test Terraform 標準のテスト機能（.tftest.hcl）の書き方ガイド テスト特化で詳細
terraform-stacks 複数環境（dev/stg/prod）を一括管理する Stacks 機能のガイド 他にない唯一のStacks対応
terraform-mcp-as-code HCP Terraform（HashiCorp のクラウドサービス）を API 経由で操作するガイド MCP経由でワークスペース操作
terraform-lsp エディタ上でコード補完・エラー検出を行う Language Server の設定ガイド コード補完・診断をSkillから制御

7-3. 注目ポイント

terraform-stacks と terraform-lsp は、
他の3つのSkillsには 存在しない 独自機能です。
HCP Terraformを使う予定がある場合は必見です。

8. ④zxkane/aws-skills

8-1. 概要

AWS CDK開発に特化したSkillsです。
Terraform向けではありませんが、MCP連携の設計パターン と コスト管理 の観点で、
Terraformユーザーにも参考になります。

8-2. プラグイン構成

プラグイン 内容 MCP連携
aws-common 共有依存（AWS Documentation MCP） AWS Documentation MCP
aws-cdk CDKベストプラクティス AWS CDK MCP
aws-cost-ops コスト最適化・モニタリング Pricing / Cost Explorer / CloudWatch
serverless-eda サーバーレス＆イベント駆動設計 なし
aws-agentic-ai Bedrock AgentCore なし

[!NOTE]
aws-common は他のプラグインの共有依存です。
aws-cdk 等をインストールする前に、先に aws-common をインストールしてください。

8-3. Terraform使いにとっての価値

このSkillsの最大の特徴は MCP（Model Context Protocol）サーバーとの統合 です。

🍽️ 比喩でいうと：

① antonbabenko/terraform-skill = レシピ本だけ（知識を提供）
④ zxkane/aws-skills = レシピ本 + 調理器具のセット（知識 + 実際に動くツール）

特に aws-cost-ops プラグインは、
AWS Pricing MCP・Cost Explorer MCP・CloudWatch MCPの3つを統合しており、
コスト見積もりをClaude Code内で完結 できます。
この設計パターンは、将来自分でSkillsを自作する際の参考になります。

9. 比較表

9-1. 機能比較

機能 ①antonbabenko ②HashiCorp公式 ③hashi-demo-lab ④zxkane/aws
スタイルガイド ✅ ✅ ✅ —
モジュール設計 ✅（詳細） ✅（リファクタ） — —
テスト戦略 ✅（判断マトリクス） — ✅（詳細） —
CI/CD ✅（GitHub Actions/GitLab CI） — — —
セキュリティ ✅（Trivy/Checkov） — — —
Terraform Stacks — — ✅ —
MCP連携 — — ✅ ✅（5 MCP）
LSP連携 — — ✅ —
プロバイダー開発 — ✅ — —
コスト管理 △（基本のみ） — — ✅（専用プラグイン）
プログレッシブ・ディスクロージャー ✅（6 references） — — —

9-2. 非機能比較

観点 antonbabenko HashiCorp公式 hashi-demo-lab zxkane/aws
Star数 831 ⭐ 60 ⭐ — 33 ⭐
成熟度 v1.6.0 初期（28コミット） 初期 初期（17コミット）
IaCツール Terraform/OpenTofu Terraform Terraform (HCP) AWS CDK
ライセンス Apache 2.0 MPL-2.0 — MIT
将来の拡張 Terraform特化 Vault/Consul予定 HCP特化 AWS特化

10. 最適な組み合わせ

10-1. 結論：「いいとこ取り」が最強

4つのSkillsは 競合ではなく補完関係 です。
それぞれの得意分野が異なるため、組み合わせることで最大の効果が得られます。

10-2. 推奨インストール順

優先度 インストールするもの 理由
① 最優先 antonbabenko/terraform-skill 最も包括的。
これだけで8割カバー
② 推奨 hashicorp/agent-skills の terraform-code-generation 公式スタイルガイドの権威性
③ 状況次第 hashi-demo-lab の terraform-test テスト設計を深めたい場合
④ 参考 zxkane/aws-skills の aws-cost-ops MCP連携のパターン学習用

10-3. インストールコマンド

# Step 1: Anton Babenkoのスキル（メイン）
/plugin marketplace add antonbabenko/terraform-skill
/plugin install terraform-skill@antonbabenko

# Step 2: HashiCorp公式（スタイルガイド補強）
/plugin marketplace add hashicorp/agent-skills
/plugin install terraform-code-generation@hashicorp

# Step 3: 必要に応じて追加
/plugin marketplace add hashi-demo-lab/claude-skill-hcp-terraform
/plugin install terraform-test@hashi-demo-lab

10-4. 手動インストールの場合

# 方法A: 個人スコープ（全プロジェクトで使える）
git clone https://github.com/antonbabenko/terraform-skill ~/.claude/skills/terraform-skill

# 方法B: プロジェクトスコープ（このプロジェクトだけ）
git clone https://github.com/antonbabenko/terraform-skill .claude/skills/terraform-skill

[!NOTE]
~/.claude/skills/ に配置すると全プロジェクトで使えます（personal scope）。
.claude/skills/ に配置するとそのプロジェクトだけで有効です（project scope）。
チームで共有する場合はproject scopeでGit管理するのが便利です。

11. シリーズの全体像

11-1. 6記事の学習パス

本シリーズは全6回で、Claude Code の機能を 段階的に 習得する構成です。

11-2. 3つのフェーズ

フェーズ 記事 テーマ
知る ①② Skills の全体像を調査し、サブエージェントで数値を検証する
使う ③④⑤ Skills を実際にインストールし、CLAUDE.md でルールを定義し、カスタムサブエージェントでレビューを自動化する
組み合わせる ⑥ カスタムエージェントを定義し、Agent Teams で複数エージェントを協調動作させる

12. 学習ロードマップ

12-1. 各記事で学ぶこと

# 記事 やること キー概念
① Skills比較（本記事） 4つの公開 Skills を調査・比較する Skills / CLAUDE.md の違い
② サブエージェント活用 並列調査で①の数値を裏付け検証する Task ツール / サブエージェント
③ Skillsインストール＆実践 Skills を実際にインストールしてコード生成を比較する Skills インストール / Before-After
④ CLAUDE.mdカスタムルール チーム独自のルール（A〜E）を定義する CLAUDE.md / ルール設計
⑤ カスタムサブエージェント自作 AI にコードレビューさせる仕組みを作る カスタムサブエージェント / プロンプト設計
⑥ カスタムエージェント＆Agent Teams 複数エージェントでインフラを構築する カスタムエージェント / Agent Teams

12-2. 本記事の次にやること

まずは ②サブエージェント活用 に進みます。
本記事で調べた数値を、
Claude Code のサブエージェント機能で並列検証します。

13. まとめ

13-1. 分かったこと

  • Terraform向けのClaude Code Skillsは、すでに 4つの主要なもの が公開されている
  • 最も包括的なのは antonbabenko/terraform-skill（831 Star、v1.6.0）
  • HashiCorp公式は スタイルガイドの権威性 が強み
  • 4つは 競合ではなく補完関係 であり、組み合わせて使うのがベスト
  • Skillsは後続の記事で 段階的に活用 していく（最終回⑥で Agent Teams と組み合わせる）

13-2. 次のステップ

この記事はあくまで「調査と比較」です。

ところで、この記事に書いた数値（行数やファイル数）は本当に正しいのでしょうか？
次の記事では、Claude Codeの サブエージェント機能 を使って
リポジトリを並列調査し、本記事の数値を裏付け検証してみます。

参考リンク

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?