tf-module-generator Skill Documentation

1. Skill Name

tf-module-generator

2. Description

Automatically generates Terraform modules from existing cloud infrastructure resources across AWS, Azure, and GCP. The skill discovers live cloud resources, creates optimized Terraform code with proper variable definitions and outputs, and validates the generated modules against Terraform best practices.

3. Core Capabilities

Scan and analyze existing cloud infrastructure resources across AWS, Azure, and GCP
Generate optimized Terraform module code with proper variable definitions and outputs
Support multiple resource types (compute, storage, networking, databases, etc.)
Generate documentation and example usage for each generated module
Validate generated Terraform syntax and best practices
Provide CLI interface with customizable output options and error handling
Integrate seamlessly with OpenClaw agent workflows for automated infrastructure management

4. Out of Scope

Infrastructure provisioning (only generates code from existing resources)
Cost optimization recommendations
Security policy enforcement
Multi-environment management (dev/staging/prod)
State management or backend configuration
Testing the generated modules beyond syntax validation
Support for non-cloud infrastructure (on-prem, hybrid environments)

5. Trigger Scenarios

"Generate Terraform module from my existing AWS EC2 instances"
"Convert my Azure resources to Terraform modules"
"Create Terraform code from my GCP cloud resources"
"Generate module for my current VPC configuration"
"Automate Terraform module creation for our cloud infrastructure"
"Generate Terraform from existing [service] resources"
"Create reusable Terraform modules from our deployed resources"

6. Requirements

Cloud provider credentials configured (AWS CLI, Azure CLI, or GCP CLI)
Node.js 18+ runtime
Access to terraform binary for validation (optional but recommended)
OpenCl agent with sessions_spawn capability

7. Key Files

SKILL.md: This documentation
scripts/main.js: CLI entry point and command parsing
scripts/aws-scanner.js: AWS resource discovery and analysis
scripts/azure-scanner.js: Azure resource discovery and analysis
scripts/gcp-scanner.js: GCP resource discovery and analysis
scripts/terraform-generator.js: Terraform module code generation logic
scripts/validator.js: Generated code syntax and best practice validation
scripts/config.js: Configuration management and provider settings
references/providers.json: Cloud provider resource schema mappings
references/templates/: Directory containing module templates for different resource types
assets/examples/: Sample usage examples and test cases
assets/terraform-version: Supported Terraform version constraints
package.json: npm package metadata and dependencies
README.md: Quick start guide

8. Acceptance Criteria

[ ] CLI successfully scans and identifies resources from at least 3 cloud providers
[ ] Generated Terraform modules pass syntax validation with terraform validate
[ ] All generated code follows Terraform best practices conventions
[ ] Skill integrates correctly with OpenClaw session_spawn for agent usage
[ ] Error handling provides clear, actionable feedback for common failure cases
[ ] Documentation includes usage examples for both CLI and agent integration
[ ] Code passes all automated tests including security checks
[ ] Generated modules include appropriate variables, outputs, and documentation
[ ] Skill triggers correctly for all defined trigger scenarios
[ ] Performance benchmarks meet targets for typical infrastructure sizes (<1k resources)