Skip to main content

Introducing HashiCorp Agent Skills

We’ve released an open library of Agent Skills to help teams build and manage infrastructure faster with AI.

Today, we're announcing HashiCorp Agent Skills, a repository of Agent Skills and Claude Code plugins for HashiCorp products. At launch, this includes Skills for Terraform and Packer.

These Skills give AI assistants specialized HashiCorp product knowledge, including plugin framework architectures, schema definitions, and up-to-date best practices. The initial HashiCorp Agent Skills pack includes Skills that can:

  • Follow HashiCorp style conventions when generating Terraform code
  • Write and run Terraform tests
  • Create orchestrations with Terraform Stacks
  • Help build Terraform providers according to best practices
  • Refactor Terraform modules
  • Build AWS, Azure, and Windows images with Packer
  • and more

In this post, we'll cover what Agent Skills are, how these skills improve your infrastructure workflow, and how to install them in your AI assistant.

»What are Agent Skills?

Agent Skills are based on an open standard for packaging domain expertise into portable, reusable instructions that AI agents can load on demand. Developed by Anthropic and released as an open format, skills solve a fundamental problem: AI assistants often lack the specific technical context needed to perform complex tasks reliably.

A note on the Model Context Protocol (MCP). You might be wondering how this differs from MCP. Agent Skills and MCP are complementary technologies. MCP is the "pipe" or server interface that connects data to an AI, while Agent Skills are the "textbooks" of knowledge. You can use them together to create a powerful, context-aware assistant.

Each Skill is a folder containing instructions, reference materials, and resources. When you load a Skill, your AI assistant gains access to curated expertise it can apply to your work, significantly reducing hallucinations and adhering to strict architectural standards.

»Skills for every stage of your DevOps journey

The HashiCorp Agent Skills package currently includes Skills that address the most common challenges that Terraform and Packer users face, with more planned for the future:

Building a new provider: Creating a Terraform provider requires understanding of the plugin framework, resource lifecycle methods, schema design, and testing patterns. Our provider development Skills give AI assistants the context to guide you through the entire process, from scaffolding a new provider to implementing complex data sources to testing, all without having to point your AI to different documents manually or risk bad practices and nonsensical results from creeping in.

Maintaining an existing provider: Provider maintenance involves handling breaking changes, updating to new framework versions, and addressing community issues. The Terraform Skills also help AI assistants understand your existing codebase and suggest changes that follow established patterns.

Generating quality Terraform code: We’ve baked our coding conventions into AI workflows with our Terraform style guide Skill. That means when you start generating Terraform configurations with the style guide Skill, the code will follow HashiCorp’s documented style conventions, rather than potentially using conventions from code found in the wild.

Breaking down monoliths: The refactor module Skill helps refactor monolithic Terraform configurations into modules, making your configurations more reusable and manageable.

Using Terraform Stacks: Terraform Stacks are a configuration layer in HCP Terraform and Terraform Enterprise designed to manage complex, multi-environment, multi-region infrastructure as a single, cohesive unit. With the Terraform Stacks Skill, you can simplify the coding process of Stack components without as many general-LLM pitfalls.

Building machine images with Packer: Packer Skills help users build golden images across AWS, Azure, and Windows with proper builder configurations, provisioners, platform-specific patterns, and HCP Packer integration for image lifecycle management.

»Evaluating our Agent Skills

A key part of creating our Skills was evaluating their efficacy and iteratively improving them based on evaluation data. Skills can significantly improve how an agent completes a task when written well. Written poorly, they may consume too much context with little gain. They can also lack critical information or be phrased in ways that different models interpret inconsistently.

HashiCorp partnered with Tessl to evaluate and improve our Agent Skills. We used two evaluation techniques:

  • Review evals, which test Skill structure against Anthropic's best practices
  • Task evals, which run agents through real tasks with and without the Skill to assess results
Run acceptance tests for Agent Skills

You can see the full review eval results on our listing here.

»Install Skills in seconds

We designed the installation process to be as simple as possible. You have a few options:

  • Using npx, run:
    •  npx skills add hashicorp/agents-skills
  • Using Tessl, run:
    •  npm i -g @tessl/cli && tessl i github:hashicorp/agent-skills --skill terraform-stacks
  • For Claude Code specifically, run:
    •  /plugin marketplace add hashicorp/agent-skills
    •  /plugin install terraform-provider-development@hashicorp

Any of these methods will install the Skill files directly into your AI assistant's configuration directory, with no manual copying or configuration editing.

»What's next

This initial release covers Terraform and Packer, but we plan to expand the library to cover additional HashiCorp products very soon.

We also welcome contributions from the community. If you have expertise to share or ideas for new Skills, visit our repository to get involved. Let us know how these Skills help your workflow and tell us what you’d like to see next by opening an issue in the repository.

»More resources

  • Keep up to date with HashiCorp Agent Skills: Follow the GitHub Repository. Install via /plugin, Tessl, or npx.
  • Learn the standard: Read about Agent Skills to understand how the open format works.
  • Scale your impact: Sign up for HCP Terraform and HCP Packer to manage your new infrastructure configurations at scale.

More posts like this