TerraShark
LukasNiessen/terrasharkTerraShark устраняет галлюцинации LLM при работе с Terraform и OpenTofu. Основан на официальных практиках HashiCorp, оптимизирован по токенам, поддерживает модульный и безопасный IaC-код.
Установка
git clone https://github.com/LukasNiessen/terrashark.gitREADME
Terraform Skill для Claude Code и Codex: TerraShark
Устраняет галлюцинации.
LLM часто галлюцинируют при работе с Terraform. Этот скилл решает проблему. Он включает лучшие практики для Terraform и OpenTofu — хорошие, плохие и нейтральные примеры, чтобы AI избегал типичных ошибок. Используя TerraShark, AI опирается на проверенные практики, устраняет галлюцинации и по умолчанию применяет модульный, переиспользуемый, security-first подход.
Высокая токен-эффективность.
Большинство Terraform-скиллов выгружают на агента огромные стены текста и сжигают дорогие токены — без какой-либо пользы. LLM не нужна вся документация Terraform ещё раз. TerraShark агрессивно дедуплицирован и оптимизирован для максимального качества на токен.
Основан на официальных практиках HashiCorp.
TerraShark базируется прежде всего на официальных рекомендациях HashiCorp. При конфликте рекомендаций приоритет отдаётся позиции HashiCorp.
Быстрый старт • Зачем TerraShark • Стратегия токенов • Что включено • Как работает • Философия
⚡ Быстрый старт за 2 минуты
Вариант 1: Клонирование
macOS / Linux:
git clone https://github.com/LukasNiessen/terrashark.git ~/.claude/skills/terrasharkWindows (Powershell):
git clone https://github.com/LukasNiessen/terrashark.git "$env:USERPROFILE\.claude\skills\terrashark"Windows (Command Prompt):
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:
# Клонируйте в корень проекта
git clone https://github.com/LukasNiessen/terrashark.git .terrasharkЗатем добавьте в AGENTS.md (или создайте файл в корне репозитория):
## Terraform
При работе с Terraform или OpenTofu следуй рабочему процессу из `.terrashark/SKILL.md`.
При необходимости загружай справочные материалы из `.terrashark/references/`.Готово!
Теперь задавайте Claude Code / Codex любые вопросы по Terraform. Ответы TerraShark следуют 7-шаговому рабочему процессу анализа сбоев и включают выходной контракт с допущениями, компромиссами и инструкциями по откату.
Явный вызов:
/terrashark Create a multi-region S3 module with replication
/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
Обзор
| Параметр | TerraShark | terraform-skill | Без скилла |
|---|---|---|---|
| Стоимость активации SKILL.md | ~600 токенов | ~4 400 токенов | 0 |
| Детализация справочников | 18 сфокусированных файлов | 6 крупных файлов | — |
| Расход токенов на запрос | Низкий (1–2 небольших справочника) | Высокий (крупные справочники, напр. 1 126 строк для модулей) | 0 |
| Архитектура | Рабочий процесс анализа сбоев | Статический справочник | — |
| Диагностика перед генерацией | Да (шаг 2) | Нет | Нет |
| Выходной контракт | Да — допущения, компромиссы, откат | Нет | Нет |
| Плейбуки миграции | Да (5 плейбуков) | Частично (встроенные фрагменты) | Нет |
| Примеры хорошего/плохого/нейтрального | Да (3 отдельных файла) | Только встроенные | Нет |
| Чеклист Do/Don't | Да (отдельный файл) | Только встроенный | Нет |