terrashark
bylukasniessen· 2 skills
Prevent Terraform/OpenTofu hallucinations by diagnosing and fixing failure modes: identity churn, secret exposure, blast-radius mistakes, CI drift, and compliance gate gaps. Use when generating, reviewing, refactoring, or migrating IaC and when building delivery/testing pipelines.
How to install terrashark?
lukasniessen/terrashark
$npx -y skills add lukasniessen/terrashark --skill terrasharkInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/lukasniessen/terrashark" --skill "lukasniessen/terrashark"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/lukasniessen/terrashark" that are relevant to the current task. Run `npx skills add "https://github.com/lukasniessen/terrashark"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # Terraform Skill for Claude Code, Codex, Antigravity, and Gemini CLI: TerraShark |
| 2 | |
| 3 | <div align="center" name="top"> |
| 4 | <img align="center" src="assets/logo.png" width="180" height="180" alt="TerraShark Logo"> |
| 5 | |
| 6 | <!-- spacer --> |
| 7 | <p></p> |
| 8 | |
| 9 | [](https://docs.claude.ai/docs/agent-skills) |
| 10 | [](https://developers.openai.com/codex/skills/) |
| 11 | [](https://geminicli.com/docs/cli/skills) |
| 12 | [](https://antigravity.google/docs/skills) |
| 13 | [](https://opensource.org/licenses/MIT) |
| 14 | [](https://github.com/LukasNiessen/terrashark) |
| 15 | |
| 16 | </div> |
| 17 | |
| 18 | The #1 Terraform skill for Claude Code and Codex, measured by GitHub stars. |
| 19 | |
| 20 | ### Fixes Hallucinations. |
| 21 | |
| 22 | LLMs hallucinate a lot when it comes to Terraform. This skill fixes it. It includes best practices for Terraform and OpenTofu - good, bad, and neutral examples so the AI avoids common mistakes. Using TerraShark, the AI keeps proven practices in mind, eliminates hallucinations, and defaults to modular, reusable, security-first design. |
| 23 | |
| 24 | ### Very Token-Efficient. |
| 25 | |
| 26 | Most Terraform skills dump huge text-of-walls onto the agent and burn expensive tokens - with no upside. LLMs don't need the entire Terraform docs again. TerraShark was aggressively de-duplicated and optimized for maximum quality per token. |
| 27 | |
| 28 | ### Based on HashiCorp's Official Best Practices. |
| 29 | |
| 30 | TerraShark is primarily based on [HashiCorp official recommended practices](https://developer.hashicorp.com/terraform/cloud-docs/recommended-practices). When guidance conflicts, it prioritizes HashiCorp's recommendations. |
| 31 | |
| 32 | --- |
| 33 | |
| 34 | [Quick Start](#-quick-start) • [Why TerraShark?](#-library-comparison) • [Token Strategy](#-token-strategy) • [What's Included](#-whats-included) • [How It Works](#-how-it-works) • [Sponsor](https://github.com/sponsors/LukasNiessen) • [Philosophy](PHILOSOPHY.md) |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## ⚡ 2 min Quickstart |
| 39 | |
| 40 | ### Option 1: Clone |
| 41 | |
| 42 | **macOS / Linux:** |
| 43 | |
| 44 | ```bash |
| 45 | git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrashark |
| 46 | ``` |
| 47 | |
| 48 | **Windows (Powershell):** |
| 49 | |
| 50 | ```powershell |
| 51 | git clone https://github.com/LukasNiessen/terrashark.git "$env:USERPROFILE\.claude\skills\terrashark" |
| 52 | ``` |
| 53 | |
| 54 | **Windows (Command Prompt):** |
| 55 | |
| 56 | ```powershell |
| 57 | git clone https://github.com/LukasNiessen/terrashark.git "%USERPROFILE%\.claude\skills\terrashark" |
| 58 | ``` |
| 59 | |
| 60 | That's it. Claude Code auto-discovers skills in `~/.claude/skills/` - no restart needed. |
| 61 | |
| 62 | ### Option 2: Marketplace |
| 63 | |
| 64 | Claude Code has a built-in plugin system with marketplace support. Instead of cloning manually, you can add TerraShark's marketplace and install directly from the CLI: |
| 65 | |
| 66 | ``` |
| 67 | /plugin marketplace add LukasNiessen/terrashark |
| 68 | /plugin install terrashark |
| 69 | ``` |
| 70 | |
| 71 | Or use the interactive plugin manager - run `/plugin`, switch to the **Discover** tab, and install from there. The marketplace reads the `.claude-plugin/marketplace.json` in this repo to register TerraShark as an installable plugin. |
| 72 | |
| 73 | ### Option 3: Codex |
| 74 | |
| 75 | Codex has no global skill system - setup is per-project. Clone TerraShark into your repo and reference it from your `AGENTS.md`: |
| 76 | |
| 77 | ```bash |
| 78 | # Clone into your project root |
| 79 | git clone https://github.com/LukasNiessen/terrashark.git .terrashark |
| 80 | ``` |
| 81 | |
| 82 | Then add to your `AGENTS.md` (or create one in the repo root): |
| 83 | |
| 84 | ```markdown |
| 85 | ## Terraform |
| 86 | |
| 87 | When working with Terraform or OpenTofu, follow the workflow in `.terrashark/SKILL.md`. |
| 88 | Load references from `.terrashark/references/` as needed. |
| 89 | ``` |
| 90 | |
| 91 | ### Option 4: Antigravity |
| 92 | |
| 93 | **macOS / Linux:** |
| 94 | |
| 95 | ```bash |
| 96 | git clone https://github.com/LukasNiessen/terrashark.git ~/.gemini/antigravity/skills/terrashark |
| 97 | ``` |
| 98 | |
| 99 | **Windows (PowerShell):** |
| 100 | |
| 101 | ```powershell |
| 102 | git clone https://github.com/LukasNiessen/terrashark.git "$env:USERPROFILE\.gemini\antigravity\skills\terrashark" |
| 103 | ``` |
| 104 | |
| 105 | Antigravity auto-discovers skills in the skills directory — no restart needed. |
| 106 | |
| 107 | ### Option 5: Gemini CLI |
| 108 | |
| 109 | Gemini CLI discovers skills in several standard locations. |
| 110 | |
| 111 | **Global Installation (All Workspaces):** |
| 112 | |
| 113 | ```bash |
| 114 | git clone https://github.com/LukasNiessen/terrashark.git ~/.gemini/skills/terrashark |
| 115 | ``` |
| 116 | |
| 117 | **Local Installation (Current Workspace):** |
| 118 | |
| 119 | ```bash |
| 120 | git clone https://github.com/LukasNiessen/terrashark.git .gemini/skills/terrashark |
| 121 | ``` |
| 122 | |
| 123 | Gemini CLI auto-discovers skills in these directories. Run `/skills list` in the CLI to verify. |
| 124 | |
| 125 | ### That's it! |
| 126 | |
| 127 | Done. Now ask Claude Code / Codex / Antigravity / Gemini CLI any Terraform question. TerraShark responses follow the 7-step failure-mode workflow and include an output contract with assumptions, tradeoffs, and rollback notes. |
| 128 | |
| 129 | **Invoke explicitly:** |
| 130 | |
| 131 | ```bash |
| 132 | /terrashark Create a multi-region S3 module with replication |
| 133 | ``` |
| 134 | |
| 135 | ```bash |
| 136 | /terrashark Refactor our EKS stack into se |
Related
6 picksType
- azure-storageAzure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.Jul 2026
- azure-resource-lookupList, find, and show Azure resources across subscriptions or resource groups.Jul 2026
- azure-resource-visualizerAnalyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources.Jul 2026
- azure-computeAzure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight…Jul 2026
- azure-quotasCheck/manage Azure quotas and usage across providers. For deployment planning, capacity validation, region selection.Jul 2026
- azure-upgradeAssess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies in source code.Jul 2026
