provider-docs — скилл для Claude Code: что делает и как установить
Скилл помогает готовить и проверять документацию провайдеров Terraform под требования Terraform Registry. Он настраивает шаблоны docs, описания схемы и запуск утилиты tfplugindocs.
npx skills add hashicorp/agent-skills --skill provider-docs -a claude-codeЧто делает provider-docs
Скилл задаёт строгий регламент подготовки страниц для Terraform Registry. Сначала разработчик формулирует описания в коде схемы, а обзорные тексты выносит в шаблоны директории docs/. Для генерации разметки используется утилита tfplugindocs через go generate или прямой вызов инструмента. Скилл проверяет соответствие аргументов, обязательных полей и вычисляемых атрибутов реальному поведению провайдера.
Специфика каталога накладывает жёсткие ограничения на сниппеты HCL. Примеры кладут строго в папку examples/ по одному файлу на случай и подключают через директиву tffile, исключая блоки terraform, provider или output. Для страниц действий, появившихся в Terraform v1.14.0+, требуется показывать связку action и action_trigger без блоков атрибутов. Это предотвращает скрытые ошибки парсинга в реестре.
Перед публикацией релиза проверяются системные маркеры. В корне репозитория обязательно должен лежать файл terraform-registry-manifest.json, а теги версий должны начинаться с префикса v вроде v1.2.3. Если пропустить манифест или поставить тег вне основной ветки, реестр не покажет обновлённую справку.
Какие задачи решает
- оформить шаблоны docs для новых ресурсов и функций провайдера
- синхронизировать описания полей схемы с документацией в Registry
- проверить примеры HCL на отсутствие лишних блоков конфигурации
- настроить генерацию markdown через утилиту tfplugindocs
- подготовить манифест и теги репозитория к публикации релиза
Примеры запросов агенту
- Обнови документацию провайдера под новый data source и сгенерируй файлы через tfplugindocs
- Проверь HCL-примеры в каталоге examples на соответствие правилам Terraform Registry
- Помоги составить шаблон action с учётом action_trigger для Terraform v1.14.0+
Как установить provider-docs
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/provider-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/provider-docs/
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-docs -a codex2Вручную: положить файлы
.agents/skills/provider-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-docs -a cursor2Вручную: положить файлы
.cursor/skills/provider-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hashicorp/agent-skills provider-docs2Вручную: положить файлы
.github/skills/provider-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/hashicorp/agent-skills --path plugins/terraform/skills/provider-docsВручную: положить файлы
.devin/skills/provider-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о provider-docs
Как установить provider-docs в Claude Code?
Выполните команду npx skills add hashicorp/agent-skills --skill provider-docs -a claude-code. Файл скилла будет сохранён по пути ~/.claude/skills/provider-docs/SKILL.md.
Что делает скилл provider-docs?
Он ведёт по шагам создания и обновления документации провайдера Terraform: от добавления текстов в схему Go и шаблонов .md.tmpl до запуска tfplugindocs и валидации файлов.
Какие требования предъявляются к примерам HCL в документации?
Каждый пример выносится в отдельный файл внутри каталога examples/ и подключается директивой tffile. В коде сниппета запрещено использовать блоки terraform, provider и output.
