Claude Info
DevOps

TerraShark

LukasNiessen/terrashark

TerraShark устраняет галлюцинации LLM при работе с Terraform и OpenTofu. Основан на официальных практиках HashiCorp, оптимизирован по токенам, поддерживает модульный и безопасный IaC-код.

Установка

terminal
bash
git clone https://github.com/LukasNiessen/terrashark.git

README

Terraform Skill для Claude Code и Codex: TerraShark

Claude Skill Codex Skill License: MIT GitHub stars

Устраняет галлюцинации.

LLM часто галлюцинируют при работе с Terraform. Этот скилл решает проблему. Он включает лучшие практики для Terraform и OpenTofu — хорошие, плохие и нейтральные примеры, чтобы AI избегал типичных ошибок. Используя TerraShark, AI опирается на проверенные практики, устраняет галлюцинации и по умолчанию применяет модульный, переиспользуемый, security-first подход.

Высокая токен-эффективность.

Большинство Terraform-скиллов выгружают на агента огромные стены текста и сжигают дорогие токены — без какой-либо пользы. LLM не нужна вся документация Terraform ещё раз. TerraShark агрессивно дедуплицирован и оптимизирован для максимального качества на токен.

Основан на официальных практиках HashiCorp.

TerraShark базируется прежде всего на официальных рекомендациях HashiCorp. При конфликте рекомендаций приоритет отдаётся позиции HashiCorp.


Быстрый стартЗачем TerraSharkСтратегия токеновЧто включеноКак работаетФилософия


⚡ Быстрый старт за 2 минуты

Вариант 1: Клонирование

macOS / Linux:

bash
git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrashark

Windows (Powershell):

powershell
git clone https://github.com/LukasNiessen/terrashark.git "$env:USERPROFILE\.claude\skills\terrashark"

Windows (Command Prompt):

powershell
git clone https://github.com/LukasNiessen/terrashark.git "%USERPROFILE%\.claude\skills\terrashark"

Готово. Claude Code автоматически обнаруживает скиллы в ~/.claude/skills/ — перезапуск не требуется.

Вариант 2: Маркетплейс

Claude Code имеет встроенную систему плагинов с поддержкой маркетплейса. Вместо ручного клонирования можно добавить маркетплейс TerraShark и установить его прямо из CLI:

/plugin marketplace add LukasNiessen/terrashark /plugin install terrashark

Или воспользуйтесь интерактивным менеджером плагинов — запустите /plugin, перейдите на вкладку Discover и установите оттуда. Маркетплейс читает .claude-plugin/marketplace.json из этого репозитория, чтобы зарегистрировать TerraShark как устанавливаемый плагин.

Вариант 3: Codex

Codex не имеет глобальной системы скиллов — настройка выполняется для каждого проекта отдельно. Клонируйте TerraShark в репозиторий и укажите ссылку в AGENTS.md:

bash
# Клонируйте в корень проекта
git clone https://github.com/LukasNiessen/terrashark.git .terrashark

Затем добавьте в AGENTS.md (или создайте файл в корне репозитория):

markdown
## Terraform

При работе с Terraform или OpenTofu следуй рабочему процессу из `.terrashark/SKILL.md`.
При необходимости загружай справочные материалы из `.terrashark/references/`.

Готово!

Теперь задавайте Claude Code / Codex любые вопросы по Terraform. Ответы TerraShark следуют 7-шаговому рабочему процессу анализа сбоев и включают выходной контракт с допущениями, компромиссами и инструкциями по откату.

Явный вызов:

/terrashark Create a multi-region S3 module with replication
bash
/terrashark Refactor our EKS stack into separate state files per environment, add moved blocks to avoid recreation, set up a GitHub Actions pipeline with plan on PR and gated apply on merge, and wire in Checkov for compliance scanning

Или просто спросите естественным языком — TerraShark активируется автоматически для любой задачи с Terraform/OpenTofu:

Review my main.tf for security issues Migrate this module from count to for_each

🎬 Демо

https://github.com/user-attachments/assets/2bc4c9ff-9f54-4a49-8bf0-5cfc0f26dec6

🏁 Зачем TerraShark

Обзор

ПараметрTerraSharkterraform-skillБез скилла
Стоимость активации SKILL.md~600 токенов~4 400 токенов0
Детализация справочников18 сфокусированных файлов6 крупных файлов
Расход токенов на запросНизкий (1–2 небольших справочника)Высокий (крупные справочники, напр. 1 126 строк для модулей)0
АрхитектураРабочий процесс анализа сбоевСтатический справочник
Диагностика перед генерациейДа (шаг 2)НетНет
Выходной контрактДа — допущения, компромиссы, откатНетНет
Плейбуки миграцииДа (5 плейбуков)Частично (встроенные фрагменты)Нет
Примеры хорошего/плохого/нейтральногоДа (3 отдельных файла)Только встроенныеНет
Чеклист Do/Don'tДа (отдельный файл)Только встроенныйНет

Похожие скиллы