Skills

modulestf: agent skills para revisar y modificar módulos de Terraform según las reglas de terraform-aws-modules

Los ingenieros que quieran revisar y modificar módulos de Terraform reutilizables según las reglas de terraform-aws-modules en un agente de código lo mejor es que empiecen con estas skills haciendo una revisión de un PR con punto de confirmación; antes de usarlas hay que configurar en el agente un servidor MCP de HashiCorp Terraform llamado terraform, o las reglas que dependen de datos de providers no se ejecutarán y la conclusión de la revisión será como mucho incierta.

Official source · modulestf

Install

git clone https://github.com/modulestf/modulestf.git && ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/

Para quién es

  • Este conjunto de agent skills está pensado para ingenieros que escriben y mantienen módulos de Terraform en Claude Code o Codex y quieren revisar o modificar módulos según las reglas escritas de la familia terraform-aws-modules. Se ejecuta en tu propia máquina, con tu propio inicio de sesión de GitHub.
  • Actualmente solo incluye un archivo de reglas: terraform-aws-modules. Si tu proyecto necesita reglas de otras familias, la evidencia oficial no indica su aplicabilidad.
  • Antes del primer uso es obligatorio configurar en el agente un servidor MCP de Terraform llamado terraform. Lo dice explícitamente la documentación oficial: sin él, las reglas que requieren datos de providers se reportan como not run, y la revisión de un PR como mucho llega a una conclusión «incierta».
  • Si no tienes claro si tu módulo pertenece a esta familia, empieza por la revisión de bajo riesgo descrita abajo.

Primer intento en 3 minutos

Requisitos previos: tener Claude Code instalado y haber conectado al agente, siguiendo las instrucciones oficiales, el servidor MCP de HashiCorp Terraform con el nombre terraform. Hay que declarar los efectos secundarios: el flujo de revisión clona el PR en un directorio temporal y ejecuta terraform init -backend=false y terraform validate en cada example; según la documentación oficial, esto no escribe state ni usa un backend real, pero sí ejecuta comandos de Terraform en el directorio temporal.

  1. Clona el repositorio y coloca los cuatro directorios de skills en el directorio de skills de Claude Code:
git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/
  1. Lanza en Claude Code una tarea de bajo riesgo: ejecutar una revisión (operación de diagnóstico) sobre el PR de un módulo de Terraform reutilizable ya existente. Señal de éxito: el agente entrega un verdict, los findings y un borrador de comentario de PR sugerido.
  2. Punto de confirmación clave: no se publica nada hasta que tú lo confirmes; al confirmar, eliges además el evento de revisión: publicar el comentario, aprobar (approve) o solicitar cambios, según los tres que enumera la documentación oficial. Si el flujo de revisión, además de los comandos y la red mencionados, lee o escribe otros archivos o accede a la red, la documentación oficial no lo detalla punto por punto; se mantiene como desconocido.
  3. Si algunas reglas aparecen como not run, comprueba primero que el servidor MCP terraform esté correctamente conectado.

Casos de uso

  1. Revisión de PR: en Claude Code, pide al agente que revise un PR abierto según las reglas de terraform-aws-modules. El flujo clona el PR en un directorio temporal, ejecuta terraform init -backend=false y terraform validate en cada example, y luego entrega una conclusión, los hallazgos y el comentario que se publicaría; nada se publica hasta que confirmes el comentario y elijas el evento de revisión.
  2. Cambios tras la revisión: una vez que la revisión entrega su conclusión, pide al agente que modifique el módulo según lo que exige el review. La documentación oficial indica que estas skills pueden «review, change and create reusable Terraform modules» y ayudan a completar los cambios que exige el review; los cambios modifican los archivos del módulo, así que antes de lanzarlos confirma qué archivos están implicados. La evidencia oficial no detalla los pasos concretos de ese flujo de cambios; lo que se puede confirmar es que ejecuta los cambios según las reglas del archivo, con la condición previa de que existan los hallazgos del review.

Límites de uso

  • Restricciones explícitas de efectos secundarios (texto oficial): ninguna skill ejecuta terraform apply, escribe state ni usa un backend real; ninguna skill hace merge, push al pull request ni resuelve threads. El flujo de revisión no publica comentarios ni eventos de revisión antes de la confirmación. Atención: la documentación oficial solo enumera las restricciones anteriores y no indica que el flujo de change sea de solo lectura; la vocación de estas skills incluye modificar y crear módulos según lo que exige el review, y ese flujo modifica los archivos del módulo, así que confirma tú mismo el alcance antes de hacer cambios.
  • Requisitos de ejecución: Claude Code o Codex en local, con tu propio inicio de sesión de GitHub; la instalación consiste en copiar o enlazar simbólicamente los cuatro directorios, y los directorios de skills de ambas plataformas son ~/.claude/skills/ y ~/.agents/skills/. No hay evidencia sobre otros métodos de instalación u otras plataformas.
  • La revisión requiere clonar primero el PR y ejecutar terraform init/validate en un directorio temporal; hace falta un entorno de Terraform en local.
  • Información clave sin confirmar: la evidencia oficial no indica las versiones de Terraform soportadas, el alcance de providers, la compatibilidad con otros agentes, ni la lista concreta de operaciones de cada flujo aparte de «review, change and create»; tampoco se detalla punto por punto el acceso completo a archivos y red de los flujos de revisión y de cambios. Se recomienda verificar primero en tu propio entorno.