Mit Claude Code entwickeln
Claude Code ist der KI-Coding-Agent von Anthropic. IronFlock stellt dafür ein Plugin mit dem Skill ironflock-templates bereit, der dem Agenten beibringt, wie eine App an IronFlock angebunden wird. Damit schreibt Claude Code die Dateien im .ironflock/-Verzeichnis Ihrer App so, wie die Plattform sie erwartet, und prüft sie, bevor Sie ein Release veröffentlichen:
| Datei | Was der Agent tun kann |
|---|---|
board-template.yml | Das Board der App erstellen: Widgets auswählen, sie an Ihre Tabellen binden, Seiten und Navigation gestalten |
data-template.yml | Tabellen und Transformationen definieren, die zu dem passen, was Ihr Code veröffentlicht |
env-template.yml | App-Parameter hinzufügen |
port-template.yml | Ports für den Fernzugriff deklarieren |
ai-template.yml | Die KI-Agenten der App und ihre Tools definieren |
Das Plugin ist öffentlich auf GitHub verfügbar: IronFlock/agent-skills.
Was der Skill enthält
- Die JSON-Schemata aller fünf Templates — dieselben, die unter
https://ironflock.com/schemas/veröffentlicht sind. - Ein Leitfaden zum Board-Template: Datenbindungen, Filter, Aggregation, Seiten, Navigation und Layout.
- Ein Katalog aller Board-Widgets, der beschreibt, für welche Daten jedes Widget gedacht ist.
- Ein Tool, das das Konfigurationsschema eines Widgets in genau der Version liest, die ein Board verwendet.
- Ein Validator, der jedes Template gegen sein Schema und gegen die Regeln prüft, deren Verletzung die Plattform sonst erst bei der Installation meldet — zum Beispiel ein Widget, das an eine nicht vorhandene Spalte gebunden ist.
Voraussetzungen
- Claude Code — siehe die Einrichtungsanleitung von Anthropic.
- Python 3.9 oder neuer für den Validator. uv wird empfohlen: Damit installiert der Validator seine Abhängigkeiten selbst. Ohne uv führen Sie einmalig
python3 -m pip install pyyaml jsonschemaaus. - Internetzugang zu
registry.npmjs.orgundcdn.jsdelivr.net, wo die Widget-Schemata veröffentlicht werden.
Den Skill installieren
Fügen Sie den Plugin-Marketplace von IronFlock hinzu und installieren Sie anschließend das Plugin daraus — entweder direkt in Claude Code oder im Terminal:
In Claude Code
/plugin marketplace add IronFlock/agent-skills
/plugin install ironflock@ironflockDas Plugin wird für Ihr Benutzerkonto installiert, sodass Claude Code es in jedem Projekt verwenden kann. Es wird in neuen Sitzungen geladen; geben Sie in einer bereits laufenden Sitzung /reload-plugins ein. Um die Installation zu prüfen, führen Sie claude plugin list aus — der Befehl listet ironflock@ironflock auf.
Auf dem neuesten Stand halten
Claude Code aktualisiert Plugins aus Marketplaces von Drittanbietern nur, wenn Sie das aktivieren. Aktivieren Sie es einmalig: Führen Sie in Claude Code /plugin aus, öffnen Sie Marketplaces, wählen Sie ironflock und anschließend Enable auto-update. Oder aktualisieren Sie manuell:
claude plugin marketplace update ironflock
claude plugin update ironflock@ironflockFür Ihr Team einrichten
Um das Plugin allen zur Verfügung zu stellen, die an einer App arbeiten, committen Sie diese Datei als .claude/settings.json in das Repository der App:
{
"extraKnownMarketplaces": {
"ironflock": {
"source": { "source": "github", "repo": "IronFlock/agent-skills" },
"autoUpdate": true
}
},
"enabledPlugins": { "ironflock@ironflock": true }
}Claude Code wendet die Datei an, sobald ein Teammitglied dem Ordner vertraut.
Den Skill verwenden
Sie müssen den Skill nicht aufrufen. Claude Code verwendet ihn von sich aus, wenn Sie an einer IronFlock-App arbeiten — zum Beispiel bei Anfragen wie:
- „Füge dieser App ein Board hinzu, das die aktuelle Temperatur jeder Maschine als Gauge und als 24-Stunden-Verlauf anzeigt.“
- „Mach das Abtastintervall pro Gerät konfigurierbar, zwischen 1 und 60 Sekunden.“
- „Mach die Web-UI auf Port 8080 per Fernzugriff erreichbar.“
Um den Skill explizit zu starten, geben Sie /ironflock:ironflock-templates ein.
Claude Code liest zuerst den Code Ihrer App, damit die Tabellen zu dem passen, was der Code veröffentlicht. Danach schreibt der Agent die Templates und führt den Validator aus, bis keine Fehler mehr übrig sind. Anschließend können Sie das Board im UI Builder öffnen und visuell anpassen — der UI Builder liest und schreibt dieselbe Datei board-template.yml.
Der Skill ändert nur Dateien im Repository Ihrer App. Veröffentlichen Sie ein neues Release Ihrer App, um die Änderungen in die Projekte zu bringen, die sie verwenden — siehe Releases & der App Store.
Templates ohne den Agenten validieren
Der Validator läuft auch eigenständig, zum Beispiel in einer CI-Pipeline:
git clone https://github.com/IronFlock/agent-skills
uv run agent-skills/plugins/ironflock/skills/ironflock-templates/scripts/validate.py path/to/your-appEr gibt pro Befund eine Zeile mit Datei, Zeile und Pfad aus und beendet sich mit Exit-Code 1, wenn er einen Fehler gefunden hat.
Deinstallieren
claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock