Terrashark — Terraform/OpenTofu Failure-Mode Workflow
A step-by-step skill that diagnoses common Terraform/OpenTofu failure modes and proposes fixes with explicit risk controls.
Dev & CodingIntermediate★ 309⑂ 24AI score 8/10Last updated: Aug 4, 2026
What it does
- Forces you to capture execution context first: runtime (
terraformvstofu), exact version, providers, state backend, execution path (local CLI, CI, HCP/TFE, Atlantis) and environment criticality. - Diagnoses one or more of five failure modes: identity churn, secret exposure, blast radius, CI drift, and compliance gate gaps.
- Loads only the relevant reference docs, with conditional docs triggered by detected backends or providers to keep context lean.
- For every fix, states why it works, what could still break, and the guardrails (tests, approvals, rollback).
- Produces real artifacts: HCL with typed vars and pinned versions,
moved/import migration plans, plan-apply-separated CI pipelines, and policy/compliance controls.
Who it's for
- DevOps and platform engineers running Terraform or OpenTofu in production
- Tech leads reviewing AI-generated IaC who want a repeatable safety checklist
- Anyone about to migrate a state backend, refactor modules, or harden an IaC pipeline
Example uses
- "Refactor this module to use for_each" → flags resource re-creation risk and drafts a
movedblock migration plan. - "Move my state from local to S3" → pulls the backend-state-safety reference and walks through locking, backup, restore, and verification commands.
- "Write a GitHub Actions workflow for Terraform" → generates plan/apply separation, plan artifacts, approval gates, and version pinning.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/LukasNiessen/terrashark/HEAD/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the SKILL.m folder from the GitHub repo LukasNiessen/terrashark into my ~/.claude/skills/terrashark/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrashark⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Create the skills directory if needed:
mkdir -p ~/.claude/skills - Clone the full repo (the reference files are required):
git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrashark - Confirm both
SKILL.mdand thereferences/folder exist inside the new directory. - Restart Claude Code, then ask something like "review this Terraform module" to trigger the skill.
- To scope it to a single project, copy the folder into that project's
.claude/skillsdirectory instead.
View source on GitHub ↗License: MIT