terraform-doc-generator

Generate README.md for Terraform modules by parsing variables, outputs, resources, and providers.

5|Updated Jul 6, 2025
One-click install
npx skills add https://github.com/GuicedEE/ai-rules --skill terraform-doc-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terraform-doc-generator
Source: https://github.com/GuicedEE/ai-rules/tree/main/skills/.curated/terraform-doc-generator
Command: npx skills add https://github.com/GuicedEE/ai-rules --skill terraform-doc-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Terraform module documentation is often manual, inconsistent, and time-consuming to maintain. This skill automates the generation of complete README.md files by extracting variables, outputs, resources, and provider requirements to produce a polished, consistent document.

Core Features & Use Cases

  • Auto-generate a comprehensive README.md for Terraform modules, including sections for usage, inputs, outputs, requirements, providers, and resources.
  • Parse Terraform files (main.tf, variables.tf, outputs.tf, versions.tf) to surface metadata and produce accurate tables and examples.
  • Support a range of module structures and provide ready-to-edit example content for quick start and onboarding.

Quick Start

Run the generator against your Terraform module to produce a complete README.md with sections for inputs, outputs, requirements, and usage examples.

Frequently Asked Questions about terraform-doc-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate a README.md for a Terraform module?

To generate a Terraform module README.md automatically, this Skill parses your variables, outputs, resources, and provider requirements to produce a complete document with usage examples and consistent formatting.

What is the best way to keep Terraform module documentation consistent?

Keeping Terraform module documentation consistent is achieved by automating the extraction of variables and outputs to generate standardized sections for inputs, requirements, providers, and usage examples.

Can I parse main.tf and variables.tf files to create Terraform usage examples?

Yes, you can parse Terraform files like main.tf, variables.tf, outputs.tf, and versions.tf to surface metadata and produce accurate tables alongside ready-to-edit example content for quick start.

Does this Terraform documentation generator support different module structures?

Yes, this Terraform documentation generator supports a range of module structures, applying the parsed metadata to produce structured sections for inputs, outputs, requirements, providers, and resources.

What sections are included in an auto-generated Terraform module README?

An auto-generated Terraform module README includes structured sections for usage, inputs, outputs, requirements, providers, and resources, while also attaching metadata such as license and contribution guidelines.

Why does my Terraform module documentation keep falling out of sync with my code?

Terraform module documentation falls out of sync when maintained manually, so automating the extraction of variables, outputs, and resources ensures your README accurately reflects your current codebase.