Skip to content
alyn
hashicorp

agent-skills

A collection of Agent skills and Claude Code plugins for HashiCorp products.

$npx skills add hashicorp/agent-skills
Stars
925
Installs
83k
Forks
136
Updated
7 days ago
License
MPL-2.0

hashicorp

Agent Skills

Open on GitHub

About the author

hashicorp

20 skills in this pack.

hashicorp

Agent Skills

67
hashicorp

terraform-search-import

Discover existing cloud resources using Terraform Search queries and bulk import them into Terraform management. Use when bringing unmanaged infrastructure under Terraform control, auditing…

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

provider-configuration

Implement Terraform provider configuration and authentication with the Plugin Framework: provider schema for credentials (Optional + Sensitive attributes), environment variable fallbacks…

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

provider-framework-migration

Migrate Terraform provider resources and data sources from Plugin SDKv2 to the Plugin Framework: muxing both plugins in one provider (terraform-plugin-mux, tf5to6server), per-resource…

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

provider-resources

Implement Terraform Provider resources and data sources using the Plugin Framework: CRUD operations, schema design, plan modifiers and validators, not-found handling, waiters for eventually…

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

provider-test-patterns

Terraform provider acceptance test patterns using terraform-plugin-testing with the Plugin Framework. Covers test structure, TestCase/TestStep fields, ConfigStateChecks with custom…

Pack92583kTesting

hashicorp

Agent Skills

65
hashicorp

terraform-policy

Write, test, or convert Terraform Policy files (.policy.hcl, .policytest.hcl, Sentinel→tfpolicy). Triggers: policy.hcl, policytest, convert sentinel, tfpolicy, write a policy.

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

terraform-stacks

Comprehensive guide for working with HashiCorp Terraform Stacks. Use when creating, modifying, or validating Terraform Stack configurations (.tfcomponent.hcl, .tfdeploy.hcl files), working…

Pack92583kDevOps

hashicorp

Agent Skills

65
hashicorp

terraform-test

Comprehensive guide for writing and running Terraform tests. Use when creating test files (.tftest.hcl), writing test scenarios with run blocks, validating infrastructure behavior with…

Pack92583kDevOps

hashicorp

Agent Skills

63
hashicorp

azure-verified-modules

Azure Verified Modules (AVM) requirements and best practices for developing certified Azure Terraform modules. Use when creating or reviewing Azure modules that need AVM certification.

Pack92583kDevOps

hashicorp

Agent Skills

63
hashicorp

provider-actions

Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before/after create, update, destroy).

Pack92583kDevOps

hashicorp

Agent Skills

63
hashicorp

provider-ephemeral-resources

Implement Terraform provider ephemeral resources with the Plugin Framework: the Open/Renew/Close lifecycle, ephemeral schema design, registration via EphemeralResources, renewal for…

Pack92583kDevOps

hashicorp

Agent Skills

63
hashicorp

refactor-module

Transform monolithic Terraform configurations into reusable, maintainable modules following HashiCorp's module design principles and community best practices.

Pack92583kCoding

hashicorp

Agent Skills

63
hashicorp

terraform-style-guide

Generate Terraform HCL code following HashiCorp's official style conventions and best practices. Use when writing, reviewing, or generating Terraform configurations.

Pack92583kDevOps

hashicorp

Agent Skills

62
hashicorp

provider-docs

Create, update, and review Terraform provider documentation for Terraform Registry using HashiCorp-recommended patterns, tfplugindocs templates, and schema descriptions. Use when adding or…

Pack92583kDevOps

hashicorp

Agent Skills

61
hashicorp

azure-image-builder

Build Azure managed images and Azure Compute Gallery images with Packer. Use when creating custom images for Azure VMs.

Pack92583kDevOps

hashicorp

Agent Skills

61
hashicorp

push-to-registry

Push Packer build metadata to HCP Packer registry for tracking and managing image lifecycle. Use when integrating Packer builds with HCP Packer for version control and governance.

Pack92583kCoding

hashicorp

Agent Skills

61
hashicorp

windows-builder

Build Windows images with Packer using WinRM communicator and PowerShell provisioners. Use when creating Windows AMIs, Azure images, or VMware templates.

Pack92583kImages & art

hashicorp

Agent Skills

60
hashicorp

aws-ami-builder

Build Amazon Machine Images (AMIs) with Packer using the amazon-ebs builder. Use when creating custom AMIs for EC2 instances.

Pack92583kDevOps

hashicorp

Agent Skills

60
hashicorp

new-terraform-provider

Use this when scaffolding a new Terraform provider with the Plugin Framework: workspace layout, go module setup, provider server main.go, and a provider.go with schema and Configure. Also…

Pack92583kDevOps

hashicorp

Agent Skills

59
hashicorp

run-acceptance-tests

Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`, when a test fails with missing…

Pack92583kTesting

From the README

How to use agent-skills

HashiCorp Agent Skills

HashiCorp Agent Skills for Terraform and Packer.

Product Skills Product bundle
Terraform 16 terraform
Packer 4 packer

See SKILLS.md for the complete catalog and lifecycle status of each Skill.

Legal note: Your use of a third-party MCP client or LLM is subject solely to that provider's terms. IBM is not responsible for the performance of those third-party tools and may be unable to support issues caused by them.

Table of Contents

Recent Updates

This repository now organizes its 20 Skills under two product plugin roots: plugins/terraform/skills/ and plugins/packer/skills/.

Migration from Legacy Plugin IDs and Paths

The product plugin bundles replace these legacy plugin IDs: terraform-code-generation, terraform-module-generation, terraform-provider-development, terraform-policy-code, packer-builders, and packer-hcp.

Replace any legacy plugin installation with terraform@hashicorp or packer@hashicorp. Replace individual paths under terraform/<category>/skills or packer/<category>/skills with plugins/<product>/skills/<skill-name>.

Install an Individual Skill

Install Agent Skills in GitHub Copilot, Claude Code, Opencode, Cursor, IBM Bob, and more.

List the repository's Skills:

npx skills add hashicorp/agent-skills

Install one Skill from its path:

npx skills add hashicorp/agent-skills/plugins/terraform/skills/terraform-style-guide
npx skills add hashicorp/agent-skills/plugins/packer/skills/aws-ami-builder

Every supported path appears in SKILLS.md.

Install a Product Plugin Bundle

Claude Code

claude plugin marketplace add hashicorp/agent-skills
claude plugin install terraform@hashicorp
claude plugin install packer@hashicorp

Codex

Add this repository's .agents/plugins/marketplace.json as a repository marketplace, then install the terraform or packer plugin in Codex. Both marketplaces expose the same product bundles and Skill directories.

Kiro

Each product root has an Agent Plugins plugin.json, so Kiro installs it as a Power. In the Kiro Powers panel, choose Add Custom Power, then Import power from GitHub, and enter the product root URL:

https://github.com/hashicorp/agent-skills/tree/main/plugins/terraform
https://github.com/hashicorp/agent-skills/tree/main/plugins/packer

To install from a local clone, choose Import power from a folder and select plugins/terraform or plugins/packer.

Repository Structure

agent-skills/
├── .agents/plugins/marketplace.json
├── .claude-plugin/marketplace.json
├── plugins/
│   ├── terraform/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── .codex-plugin/plugin.json
│   │   ├── plugin.json
│   │   └── skills/
│   └── packer/
│       ├── .claude-plugin/plugin.json
│       ├── .codex-plugin/plugin.json
│       ├── plugin.json
│       └── skills/
└── SKILLS.md

Governance and Support

  • CONTRIBUTING.md for contribution guidance. Contributions are restricted to HashiCorp-internal contributors until further notice.
  • SECURITY.md for instructions on reporting security or data sensitivity issues related to this repository's Agent Skills.
  • SUPPORT.md defines repository support boundaries.
  • SUPPORTED_MODELS.md defines the current Anthropic and OpenAI supported model matrix.
  • CODEOWNERS for canonical Skill ownership and review-routing source.

License

MPL-2.0

Questions

What is hashicorp/agent-skills?

A collection of Agent skills and Claude Code plugins for HashiCorp products.

How do I install agent-skills?

Run "npx skills add hashicorp/agent-skills" and choose the skills you want. Many packs also document their own install path (for example a Claude Code plugin marketplace) in the README below.

How many skills are in agent-skills?

20 SKILL.md skills. Alyn lists 20 of them with their own pages.