Official agent skill

Smarterr

by hashicorp in hashicorp/terraform-provider-aws

Refactor error handling to use smarterr. An agent skill from hashicorp/terraform-provider-aws.

OfficialMPL-2.0Auto-check passedDevOps & Cloud

Install Smarterr

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/smarterr .claude/skills/smarterr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .claude/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/smarterr .agents/skills/smarterr && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .agents/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/smarterr .cursor/skills/smarterr && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .cursor/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/hashicorp/terraform-provider-aws.git --path .agents/skills/smarterr

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/smarterr .gemini/skills/smarterr && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .gemini/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/smarterr .github/skills/smarterr && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .github/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hashicorp/terraform-provider-aws --skill smarterr -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install hashicorp/terraform-provider-aws smarterr --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hashicorp/terraform-provider-aws.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/smarterr .opencode/skills/smarterr && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "smarterr" agent skill from https://github.com/hashicorp/terraform-provider-aws/tree/main/.agents/skills/smarterr into .opencode/skills/smarterr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "smarterr", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: smarterr
GitHub stars: 11k
Token cost: ~722 tokens
SKILL.md length: 229 words
Files: 1
Skills in repo: 17
Repo updated: Oct 9, 2026
First seen: Oct 8, 2026
Licence: MPL-2.0

At a glance

Refactor error handling to use smarterr. An agent skill from hashicorp/terraform-provider-aws.

Works in 4 steps: Legacy Diagnostic Calls → smerr → Bare Error Returns → smarterr → tfresource Helpers → smarterr → …
Tasks that involve Refactoring
SKILL.md covers When to use, Inputs, Core Concept and Migration Patterns, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Smarterr is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization. Refactor error handling to use smarterr.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Refactoring and Infrastructure as code. It works with Terraform. The repository describes itself as: The AWS Provider enables Terraform to manage AWS resources. The licence is MPL-2.0.

When your agent uses it

Tasks that involve Refactoring
Tasks that involve Infrastructure as code

Example prompts

“/smarterr”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Legacy Diagnostic Calls → smerr
Bare Error Returns → smarterr
tfresource Helpers → smarterr
Direct Diagnostics Calls

What it can do on your machine

Read from SKILL.md and the folder at commit 64d3359. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are go).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Smarterr loads about 722 tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 229 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~12
When it runs · the whole SKILL.md, loaded when a task matches: ~722

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashicorp/terraform-provider-aws at commit 64d3359, republished under its MPL-2.0 licence (© hashicorp). 229 words, ~722 tokens.

Download SKILL.mdSave it as .claude/skills/smarterr/SKILL.md (or your agent's skills folder).

name: smarterr
description: Refactor error handling to use smarterr.

<!-- Copyright IBM Corp. 2014, 2026 -->

<!-- SPDX-License-Identifier: MPL-2.0 -->

Skill: Smarterr

Assume the @maintainer persona.

Use this skill to refactor error handling to use smarterr (internal/smerr[../../../internal/smerr/]).

When to use

Trigger this skill when the user:

Says "use smarterr for error handling", "migrate to smerr", or similar.

Inputs

Required:

The target resource name (e.g. aws_s3_bucket).

If the user provides a human readable name (e.g. "S3 Bucket") rather than the Terraform resource, confirm the target resource before proceeding.

Core Concept

Use smerr (provider wrapper) for all diagnostic calls
Use smarterr only for bare error returns
Framework uses "Add" verbs, SDKv2 uses "Append" verbs

Migration Patterns

1. Legacy Diagnostic Calls → smerr

Legacy	Replace With
`sdkdiag.AppendFromErr(diags, err)`	`smerr.Append(ctx, diags, err)`
`sdkdiag.AppendErrorf(diags, "msg", err)`	`smerr.Append(ctx, diags, err, smerr.ID, id)`
`response.Diagnostics.AddError("msg", err.Error())`	`smerr.AddError(ctx, &response.Diagnostics, err)`
`create.AppendDiagError(diags, ..., err)`	`smerr.Append(ctx, diags, err, smerr.ID, id)`

2. Bare Error Returns → smarterr

// Before
return nil, err

// After
return nil, smarterr.NewError(err)

3. tfresource Helpers → smarterr

// Before
return tfresource.AssertSingleValueResult(...)

// After
return smarterr.Assert(tfresource.AssertSingleValueResult(...))

4. Direct Diagnostics Calls

Framework:

// Before: resp.Diagnostics.Append(...)
// After:  smerr.AddEnrich(ctx, &resp.Diagnostics, ...)

SDKv2:

// Before: return append(diags, someFunc()...)
// After:  return smerr.AppendEnrich(ctx, diags, someFunc())

Function Reference

Framework (Add verbs):

smerr.AddError(ctx, &response.Diagnostics, err, smerr.ID, id)
smerr.AddEnrich(ctx, &response.Diagnostics, diagnosticFunc())

SDKv2 (Append verbs):

smerr.Append(ctx, diags, err, smerr.ID, id)
smerr.AppendEnrich(ctx, diags, diagnosticFunc())

Both contexts:

smarterr.NewError(err) - Wrap bare returns
smarterr.Assert(tfresource.AssertSingleValueResult(...)) - Wrap helpers

Key Rules

Always pass ctx first
Always include smerr.ID, resourceID when available (e.g., d.Id(), state.Name.String())
Framework = Add verbs, SDKv2 = Append verbs
Preserve all existing IDs and context

Identify Framework vs SDKv2

Framework: @FrameworkResource, uses terraform-plugin-framework
SDKv2: @SDKResource, uses terraform-plugin-sdk/v2, returns *schema.Resource

Apply these patterns exactly. No schema or logic changes.

Files

Just SKILL.md in .agents/skills/smarterr of hashicorp/terraform-provider-aws.

Open the folder on GitHubat commit 64d3359

Compare with similar skills

Smarterr next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Smarterr compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Smarterr this skillhashicorp/terraform-provider-aws	11k	—	~722	Automated safety check: Pass	MPL-2.0	today
Heroku To AWSaws/agent-toolkit-for-aws	2.8k	—	~7.2k	Automated safety check: Pass	Apache-2.0	today
GCP To AWSaws/agent-toolkit-for-aws	2.8k	—	~15k	Automated safety check: Pass	Apache-2.0	today
Terravision Cloud Diagramspatrickchugh/terravision	1.6k	—	~5.6k	Automated safety check: Notes	AGPL-3.0-only	2 days ago
Resource Designermicrosoft/terraform-provider-fabric	128	—	~6k	Automated safety check: Pass	MPL-2.0	3 days ago
Avm Tf LifecycleAzure/terraform-azurerm-avm-ptn-alz	135	—	~1.9k	Automated safety check: Pass	MIT	3 days ago

Similar skills

Heroku To AWS
aws/agent-toolkit-for-aws
Official
Migrate workloads from Heroku to AWS. An agent skill from aws/agent-toolkit-for-aws.
2.8k GitHub stars~7.2k tokensUpdated today
DevOps & CloudAuto-check passed
GCP To AWS
aws/agent-toolkit-for-aws
Official
Migrate workloads from Google Cloud Platform to AWS — plus AI and agentic workloads from any provider.
2.8k GitHub stars~15k tokensUpdated today
DevOps & CloudAuto-check passed
Terravision Cloud Diagrams
patrickchugh/terravision
Draw cloud architecture diagrams for AWS, Azure or GCP with the official provider icon sets, using TerraVision.
1.6k GitHub stars~5.6k tokensUpdated 2 days ago
DevOps & CloudAuto-check: notes
Resource Designer
microsoft/terraform-provider-fabric
Official
Research SDK contracts, design Terraform schema approach, and compose a GitHub issue for a new resource, data source, ephemeral resource, or enhancement to an existing resource.
128 GitHub stars~6k tokensUpdated 3 days ago
DevOps & CloudAuto-check passed
Avm Tf Lifecycle
Azure/terraform-azurerm-avm-ptn-alz
Official
A skill your agent uses whenever an Azure Verified Module (AVM) is being proposed, approved, published, handed over to a new owner, orphaned, or deprecated — and whenever a contributor is choosing a…
135 GitHub stars~1.9k tokensUpdated 3 days ago
DevOps & CloudAuto-check passed
AWS Architecture Diagram
awslabs/agent-plugins
Official
Generate validated AWS architecture diagrams as draw.io XML using official AWS4 icon libraries.
915 GitHub stars~3.8k tokensUpdated today
DevOps & CloudAuto-check: notes

More from hashicorp/terraform-provider-aws

All 17 skills in this repo

Review Docs
hashicorp/terraform-provider-aws
Official
Review a Terraform AWS Provider PR's end-user documentation (website/docs//.markdown): whether docs are needed, description openings, argument/attribute style, section structure, tags wording, code…
11k GitHub stars~1.3k tokensUpdated today
Auto-check passed
Review Helpers
hashicorp/terraform-provider-aws
Official
Review Terraform AWS Provider helper code: finders, status functions, waiters, sweepers, data sources, and list resources.
11k GitHub stars~978 tokensUpdated today
Auto-check passed
Review Identity
hashicorp/terraform-provider-aws
Official
Review Terraform AWS Provider Resource Identity: the identity-strategy annotations (@ArnIdentity, @SingletonIdentity, @IdentityAttribute), multi-attribute @ImportIDHandler parsers, and region…
11k GitHub stars~692 tokensUpdated today
Auto-check passed
Review Lifecycle
hashicorp/terraform-provider-aws
Official
Review Terraform AWS Provider resource lifecycle: CRUD step order, smerr/smarterr error handling, and AutoFlex model-to-SDK conversion.
11k GitHub stars~990 tokensUpdated today
Auto-check passed
Review Schema
hashicorp/terraform-provider-aws
Official
Review Terraform AWS Provider Plugin Framework schema shape: model structs, Required/Optional/Computed combinations, plan modifiers (no ForceNew), nested-block custom types, validators, sensitive…
11k GitHub stars~1k tokensUpdated today
Auto-check passed
Review Tags
hashicorp/terraform-provider-aws
Official
Review Terraform AWS Provider tagging: the tags/tagsall schema attributes, the @Tags(identifierAttribute=...) annotation, and wiring input.Tags = getTagsIn(ctx) after flex.Expand.
11k GitHub stars~462 tokensUpdated today
Auto-check passed

Works with

Terraform

Questions about Smarterr

What does Smarterr do?

Refactor error handling to use smarterr. An agent skill from hashicorp/terraform-provider-aws. Smarterr is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization. Refactor error handling to use smarterr.

When should I use Smarterr?

Smarterr fits situations like: tasks that involve Refactoring; tasks that involve Infrastructure as code.

How do I install Smarterr in Claude Code?

Run `npx skills add hashicorp/terraform-provider-aws --skill smarterr -a claude-code`. Or copy the skill folder (.agents/skills/smarterr in hashicorp/terraform-provider-aws) into .claude/skills/smarterr in your project. Claude Code loads it when a task matches its description.

How do I install Smarterr in Codex?

Run `npx skills add hashicorp/terraform-provider-aws --skill smarterr -a codex`. Or copy the skill folder (.agents/skills/smarterr in hashicorp/terraform-provider-aws) into .agents/skills/smarterr in your project. Codex loads it when a task matches its description.

Can I use Smarterr in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashicorp/terraform-provider-aws --skill smarterr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/smarterr, .gemini/skills/smarterr, .github/skills/smarterr and .opencode/skills/smarterr in your project.

What does Smarterr need to run?

SKILL.md names no scripts, command-line tools or credentials: Smarterr is instructions for the agent only.

Does Smarterr access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Smarterr safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Smarterr use?

Smarterr is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Smarterr use?

About 722 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Smarterr?

Skills that share tags, products or a category with Smarterr: Heroku To AWS (aws/agent-toolkit-for-aws, 2.8k stars), GCP To AWS (aws/agent-toolkit-for-aws, 2.8k stars), Terravision Cloud Diagrams (patrickchugh/terravision, 1.6k stars) and Resource Designer (microsoft/terraform-provider-fabric, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Smarterr?

hashicorp (a GitHub organization, an official publisher) maintains it in hashicorp/terraform-provider-aws, which has 11,111 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

Source: hashicorp/terraform-provider-aws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Smarterr

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Skill: Smarterr

When to use

Inputs

Core Concept

Migration Patterns

1. Legacy Diagnostic Calls → smerr

2. Bare Error Returns → smarterr

3. tfresource Helpers → smarterr

4. Direct Diagnostics Calls

Function Reference

Key Rules

Identify Framework vs SDKv2

Files

Compare with similar skills

Similar skills

More from hashicorp/terraform-provider-aws

Related

Questions about Smarterr