Skills

modulestf: Agent Skills zum Prüfen und Ändern von Terraform-Modulen nach den terraform-aws-modules-Regeln

Ingenieure, die wiederverwendbare Terraform-Module in Coding-Agents nach den terraform-aws-modules-Regeln prüfen und ändern möchten, beginnen am besten mit einer Prüfung eines PR inklusive Bestätigungspunkt; vor der Nutzung muss dem Agent ein HashiCorp Terraform MCP Server mit dem Namen terraform konfiguriert werden, sonst laufen Regeln, die von Provider-Fakten abhängen, nicht, und das Prüfergebnis bleibt höchstens unsicher.

Official source · modulestf

Install

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

Für wen geeignet

  • Diese Agent Skills richten sich an Ingenieure, die in Claude Code oder Codex Terraform-Module schreiben und pflegen und Module nach den dokumentierten Regeln der terraform-aws-modules-Familie prüfen oder ändern möchten. Sie laufen auf deinem eigenen Rechner mit deinem eigenen GitHub-Login.
  • Aktuell wird nur ein Regelprofil mitgeliefert: terraform-aws-modules. Falls dein Projekt Regeln anderer Familien benötigt, geben die offiziellen Quellen keine Auskunft über deren Anwendbarkeit.
  • Vor der ersten Nutzung muss dem Agent ein Terraform-MCP-Server mit dem Namen terraform konfiguriert werden. Die offizielle Dokumentation stellt klar: Ohne ihn werden Regeln, die Provider-Fakten benötigen, als not run gemeldet, und eine PR-Prüfung liefert höchstens ein „unsicher“-Ergebnis.
  • Wenn unklar ist, ob dein Modul zu dieser Familie gehört, beginne mit der risikoarmen Prüfung weiter unten.

Erster Versuch in 3 Minuten

Voraussetzungen: Claude Code ist installiert, und der HashiCorp Terraform MCP Server ist gemäß den offiziellen Anweisungen unter dem Namen terraform an den Agent angebunden. Zu deklarierende Nebeneffekte: Der Prüf-Workflow klont den PR in ein temporäres Verzeichnis und führt in jedem Example terraform init -backend=false und terraform validate aus – laut offizieller Dokumentation wird dabei kein State geschrieben und kein echtes Backend verwendet, aber es werden Terraform-Befehle im temporären Verzeichnis ausgeführt.

  1. Klone das Repository und lege alle vier Skill-Verzeichnisse im Skills-Verzeichnis von Claude Code ab:
git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/
  1. Starte in Claude Code eine risikoarme Aufgabe: Führe eine Prüfung (diagnostische Operation) für den PR eines bestehenden wiederverwendbaren Terraform-Moduls durch. Erfolgssignal: Der Agent liefert ein verdict, findings und einen Entwurf für einen vorgeschlagenen PR-Kommentar.
  2. Wichtiger Bestätigungspunkt: Vor deiner Bestätigung wird nichts veröffentlicht; bei der Bestätigung wählst du zugleich das Review-Ereignis – Kommentar veröffentlichen, Approve oder Änderung anfordern, gemäß den offiziell genannten drei Optionen. Ob der Prüf-Workflow darüber hinaus weitere Dateien liest oder schreibt oder auf das Netzwerk zugreift, ist offiziell nicht im Einzelnen dokumentiert und bleibt unbekannt.
  3. Falls einzelne Regeln als not run gemeldet werden, prüfe zuerst, ob der terraform-MCP-Server korrekt angebunden ist.

Anwendungsfälle

  1. PR-Prüfung: Lass den Agent in Claude Code einen offenen PR nach den terraform-aws-modules-Regeln prüfen. Der Workflow klont den PR in ein temporäres Verzeichnis, führt in jedem Example terraform init -backend=false und terraform validate aus und liefert dann ein Ergebnis, Fundstellen und einen Entwurf des zu veröffentlichenden Kommentars; bevor du den Kommentar bestätigst und ein Review-Ereignis auswählst, wird nichts veröffentlicht.
  2. Änderungen nach der Prüfung: Nachdem die Prüfung ein Ergebnis geliefert hat, lass den Agent das Modul gemäß den Anforderungen des Reviews ändern. Die offizielle Dokumentation besagt, dass diese Skills „review, change and create reusable Terraform modules“ und bei den vom Review geforderten Änderungen helfen; die Änderung modifiziert Moduldateien, daher kläre vor dem Start, welche Dateien betroffen sind. Die offiziellen Quellen listen keine Schritt-für-Schritt-Details dieser Änderung auf; feststellen lässt sich, dass sie die Änderungen nach den Regeln des Profils ausführt, sofern zuvor Fundstellen aus dem Review vorliegen.

Grenzen der Nutzung

  • Explizite Nebenwirkungsbeschränkungen (offizieller Wortlaut): Kein Skill führt terraform apply aus, schreibt State oder verwendet ein echtes Backend; kein Skill führt einen Merge durch, pusht in einen Pull Request oder löst Threads auf. Vor der Bestätigung werden weder Kommentare noch Review-Ereignisse veröffentlicht. Beachte: Die offizielle Dokumentation nennt nur die genannten Einschränkungen und sagt nicht, dass der Change-Workflow schreibgeschützt ist – der Anspruch dieser Skills umfasst das Ändern und Erstellen von Modulen gemäß Review-Anforderungen, dieser Workflow modifiziert Moduldateien; prüfe den Umfang daher selbst, bevor du Änderungen startest.
  • Voraussetzungen für den Betrieb: Lokale Ausführung in Claude Code oder Codex mit deinem eigenen GitHub-Login; die Installation erfolgt durch Kopieren oder symbolisches Verknüpfen der vier Verzeichnisse, die Skills-Verzeichnisse sind auf den beiden Plattformen ~/.claude/skills/ bzw. ~/.agents/skills/. Zu anderen Installationswegen oder Plattformen gibt es keine Angaben.
  • Die Prüfung erfordert, dass der PR zuvor geklont und terraform init/validate in einem temporären Verzeichnis ausgeführt werden; lokal muss eine Terraform-Umgebung vorhanden sein.
  • Unbestätigte Kerninformationen: Die offiziellen Quellen geben keine Auskunft über unterstützte Terraform-Versionen, den Provider-Umfang, die Kompatibilität mit anderen Agents sowie über konkrete Schrittlisten der einzelnen Workflows abgesehen von „review, change and create“; auch der vollständige Umfang des Datei- und Netzwerkzugriffs der Prüf- und Änderungs-Workflows ist nicht im Einzelnen aufgelistet. Es empfiehlt sich, alles vor der Nutzung in deiner Umgebung zu verifizieren.