Official agent skill

Review PR

by hashicorp in hashicorp/terraform-provider-aws

Review a Terraform AWS Provider pull request for correctness and conventions.

OfficialMPL-2.0Auto-check passedDevelopment

Install Review PR

skills CLI
$ npx skills add hashicorp/terraform-provider-aws --skill review-pr -a claude-code

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

GitHub CLI
$ gh skill install hashicorp/terraform-provider-aws review-pr --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/review-pr .claude/skills/review-pr && 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/

Facts

Skill name
review-pr
GitHub stars
11k
Token cost
~1.1k tokens
SKILL.md length
462 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MPL-2.0

At a glance

Review a Terraform AWS Provider pull request for correctness and conventions.

  • Works in 5 steps: Fetch the PR's changed files and diff. → Categorize each changed path against the… → Load the matching leaf skill(s) and… → …
  • Given a hashicorp/terraform-provider-aws PR URL and asked to review it
  • SKILL.md covers When to use, Inputs, Procedure and Cross-cutting principles, plus 2 more sections
  • Calls make

What it does

Review PR is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization. Review a Terraform AWS Provider pull request for correctness and conventions. Start here for any PR review: it holds the cross-cutting review principles and routes to scoped sub-skills (review-lifecycle, review-schema, review-helpers, review-identity, review-tags, review-generated, review-tests, review-tests-helpers, review-docs) based on which files the PR changes. Use when given a hashicorp/terraform-provider-aws PR URL and asked to review it.

Its SKILL.md is about 1.1k 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 Development, covering Pull requests and Infrastructure as code. It works with Terraform and Amazon Web Services. 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

  • Given a hashicorp/terraform-provider-aws PR URL and asked to review it
  • Tasks that involve Pull requests
  • Tasks that involve Infrastructure as code

Example prompts

  • “/review-pr”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Fetch the PR's changed files and diff.
  2. Categorize each changed path against the routing table below.
  3. Load the matching leaf skill(s) and apply their rules to the changed lines only.
  4. Always consider compatibility (see below) and, when docs or a changelog are expected but missing, say so.
  5. Consolidate findings into a single review. Cite the rule and propose corrected code.

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

    Shell commands in SKILL.md call:

    • make

    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

Review PR loads about 1.1k tokens when it runs. Until then it costs about 115 tokens; SKILL.md has 462 words of instructions outside code blocks.

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

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). 462 words, ~1,086 tokens.

Download SKILL.mdSave it as .claude/skills/review-pr/SKILL.md (or your agent's skills folder).
name
review-pr
description
Review a Terraform AWS Provider pull request for correctness and conventions. Start here for any PR review: it holds the cross-cutting review principles and routes to scoped sub-skills (review-lifecycle, review-schema, review-helpers, review-identity, review-tags, review-generated, review-tests, review-tests-helpers, review-docs) based on which files the PR changes. Use when given a hashicorp/terraform-provider-aws PR URL and asked to review it.
<!-- Copyright IBM Corp. 2014, 2026 -->
<!-- SPDX-License-Identifier: MPL-2.0 -->

Skill: Review a Pull Request

Assume the @maintainer persona.

Review a GitHub Pull Request against the Terraform AWS Provider's conventions. This skill carries the cross-cutting principles and a routing table; load the scoped leaf skills for the file types the PR actually changes.

When to use

Trigger this skill when the user:

  • Provides a https://github.com/hashicorp/terraform-provider-aws/pull/<N> URL and asks for a review.
  • Says "review PR", "review this pull request", or similar, with a PR URL.

Inputs

Required:

  • A GitHub PR URL. Extract <PR_NUMBER> with the regex /pull/(\d+).

If the user provides only a PR number, ask for the full URL (or confirm the repo is hashicorp/terraform-provider-aws).

Procedure

  1. Fetch the PR's changed files and diff.
  2. Categorize each changed path against the routing table below.
  3. Load the matching leaf skill(s) and apply their rules to the changed lines only.
  4. Always consider compatibility (see below) and, when docs or a changelog are expected but missing, say so.
  5. Consolidate findings into a single review. Cite the rule and propose corrected code.

Cross-cutting principles

Compatibility is non-negotiable. Changes must preserve Terraform state compatibility, upgrade behavior, import behavior, and existing user workflows. Schema changes that force replacement, rename attributes, or break state migration must be flagged unless explicitly justified. For a dedicated compatibility pass, use the breaking-changes skill. Do not rely on any breaking-change label.

Favor recent patterns; do not enforce legacy ones. The provider has both modern (Plugin Framework) and legacy (Plugin SDKv2) code. New work follows recent patterns. Do not ask contributors to mimic legacy patterns just because nearby code uses them. When modifying an existing resource, keep the framework it already uses.

Go style. Expect modern Go (1.26+): slices, maps, cmp, iter, errors.Is/errors.As, range-over-int/func. Prefer return-early. AWS SDK for Go v2 only. Detect AWS API exceptions with errs.IsA[*awstypes.<Exception>] — never type assertions or strings.Contains.

Show full SKILL.md (158 more words)Show less

Review tone. Be specific, accurate, and to the point. Cite the rule and propose the corrected code. Prioritize correctness, design, and compatibility. Don't hand-author comments for mechanical issues that make lint, semgrep, or formatters already enforce — at most, note that automated checks will flag them. Spend the review on what tools can't catch: logic, AWS API usage, state and upgrade compatibility, and test coverage.

Routing table

Changed pathConcernLeaf skill
internal/service/**/*.go (non-test)CRUD, errors, AutoFlexreview-lifecycle
internal/service/**/*.go (non-test)Model/attrs/blocks/validatorsreview-schema
internal/service/**/*.go (non-test)Finders, waiters, sweepers, data sources, list resourcesreview-helpers
internal/service/**/*.go (non-test)Resource Identityreview-identity
internal/service/**/*.go (non-test)Tagsreview-tags
internal/service/**/*_gen.goGenerated codereview-generated
internal/service/**/*_test.goAcceptance/unit test basicsreview-tests
internal/service/**/*_test.goExists/Destroy, data source/list/unit testsreview-tests-helpers
website/docs/**/*.markdownEnd-user documentationreview-docs

Multiple leaves may apply to one file. The internal/service/**/*.go glob matches both production and test files; the non-test leaves generally don't apply to tests.

Broader context

See AGENTS.md for personas, the skills registry, build/test commands, and the AI-usage policy.

© hashicorp, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

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

Open the folder on GitHubat commit 64d3359

Compare with similar skills

Review PR 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.

Review PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Review PR this skillhashicorp/terraform-provider-aws11k—~1.1kAutomated safety check: PassMPL-2.0
Provider Verificationmondoohq/mql412—~3.7kAutomated safety check: PassCustom licence
Terravision Cloud Diagramspatrickchugh/terravision1.6k—~5.6kAutomated safety check: NotesAGPL-3.0-only
PR Reviewaws/aws-cdk-cli107—~2kAutomated safety check: PassApache-2.0
AWS Architecture Diagramawslabs/agent-plugins915—~3.8kAutomated safety check: NotesApache-2.0
Document Serviceawslabs/agent-plugins915—~4.4kAutomated safety check: PassApache-2.0

Similar skills

  • Verify mql provider resource/field changes against real cloud infrastructure.

    412 GitHub stars~3.7k tokensUpdated yesterday
    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 3 days ago
    DevOps & CloudAuto-check: notes
  • PR Review

    aws/aws-cdk-cli

    Official

    AWS CDK CLI general PR reviewer. An agent skill from aws/aws-cdk-cli.

    107 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-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 yesterday
    DevOps & CloudAuto-check: notes
  • Document Service

    awslabs/agent-plugins

    Official

    This skill should be used when the user asks to "analyze this codebase", "document this service", "generate technical docs", "I inherited this code", "help me understand this system", "create docs…

    915 GitHub stars~4.4k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Avm Tf Process

    Azure/terraform-azurerm-avm-ptn-alz

    Official

    A skill your agent uses for the AVM Terraform contribution process from module proposal and repository setup through implementation, Avm.Authoring validation, pull request review, and release.

    135 GitHub stars~1.5k tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed

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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Questions about Review PR

What does Review PR do?

Review a Terraform AWS Provider pull request for correctness and conventions. Review PR is an agent skill from hashicorp/terraform-provider-aws, published by the product's own GitHub organization. Review a Terraform AWS Provider pull request for correctness and conventions.

When should I use Review PR?

Review PR fits situations like: given a hashicorp/terraform-provider-aws PR URL and asked to review it; tasks that involve Pull requests; tasks that involve Infrastructure as code.

How do I install Review PR in Claude Code?

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

How do I install Review PR in Codex?

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

Can I use Review PR 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 review-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/review-pr, .gemini/skills/review-pr, .github/skills/review-pr and .opencode/skills/review-pr in your project.

What does Review PR need to run?

Going by SKILL.md and its folder, Review PR needs the command-line tools its instructions call (make).

Does Review PR 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 Review PR 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 Review PR use?

Review PR 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 Review PR use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Review PR?

Skills that share tags, products or a category with Review PR: Provider Verification (mondoohq/mql, 412 stars), Terravision Cloud Diagrams (patrickchugh/terravision, 1.6k stars), PR Review (aws/aws-cdk-cli, 107 stars) and AWS Architecture Diagram (awslabs/agent-plugins, 915 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Review PR?

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.