🔧 HashiCorp 공식 Agent Skills — Claude Code & Antigravity에서 Terraform·Packer AI를 쓰는 법
by gasbugs2026. 4. 3.
반응형
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 최신 스키마를 모릅니다. 그래서 deprecated된 attribute를 쓰거나, HashiCorp이 권장하지 않는 패턴으로 코드를 짜버립니다.
HashiCorp Agent Skills는 이 문제를 해결하기 위해 등장했습니다. AI 어시스턴트가 복잡한 작업을 신뢰성 있게 수행하는 데 필요한 특정 기술 컨텍스트가 부족하다는 근본적인 문제를 해결하는 오픈 포맷 기반의 도메인 전문 지식 패키지입니다.
처음 출시 시 Terraform과 Packer용 Skills를 포함하며, 플러그인 프레임워크 아키텍처, 스키마 정의, 최신 베스트 프랙티스 등의 전문 지식을 AI 어시스턴트에게 제공합니다.
🔍 Agent Skills vs MCP — 뭐가 다른가요?
헷갈리기 쉬운 두 개념인데, 역할이 완전히 다릅니다.
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 코드를 생성할 수 있습니다.
