Zum Hauptinhalt springen

Coding-Agenten

Ein Coding-Agent kann eine Vorlage schreiben und den Code, der ihr Daten schickt, aber er kennt Formfeed nicht: wohin die Dateien einer Vorlage gehören, wie jede Vorlagensprache einen Helper aufruft, welcher Befehl was prüft und was Einheiten kostet. Das Formfeed-Plugin sagt es ihm. Es hat zwei Teile:

  • Zwei Skills, Anleitungen, die der Agent lädt, wenn eine Aufgabe sie braucht:
    • formfeed-templates schreibt, ändert, prüft, zeigt in der Vorschau und rendert Vorlagen als Dateien mit der formfeed-CLI. Der Agent nimmt ihn, wenn ein Projekt eine formfeed.json hat, wenn Sie um eine PDF-, Bild-, Word- oder PowerPoint-Vorlage bitten oder wenn Vorlagen von einem anderen Anbieter umziehen.
    • formfeed-api schreibt den Anwendungscode, der Dokumente erzeugt: ein Rendering, das Warten auf ein asynchrones, Batches, Webhooks und Fehler, mit dem TypeScript- oder Python-SDK oder über HTTP aus jeder anderen Sprache.
  • Den gehosteten MCP-Server, mit dem der Agent Ihre Vorlagen auflistet, die Daten liest, die jede erwartet, Daten prüft und rendert, angemeldet mit Ihrem Formfeed-Konto.

Die Skills bringen mit, worin der Agent nachschlägt: jeden Befehl der CLI mit seinen Optionen, jeden Helper in allen drei Vorlagensprachen, die Fehlercodes der API und dieselbe Anfrage in acht Sprachen. Jedes Release schreibt sie aus der CLI, der Engine und der Dokumentation dieses Releases, deshalb nennt ein Skill nie eine Option oder einen Helper, den die installierte Version nicht hat.

Installieren​

Claude Code​

claude plugin marketplace add formfeed-dev/skills
claude plugin install formfeed@formfeed-dev

Claude Code ab 2.1.292 erledigt beides mit einem Befehl, claude plugin install formfeed --marketplace formfeed-dev/skills. In einer Sitzung öffnet /plugin install formfeed --marketplace formfeed-dev/skills die Details des Plugins, wo Sie wählen, ob es Ihnen in jedem Projekt gilt, dem Repository für alle oder nur Ihnen in diesem Repository.

Das Plugin lädt in der nächsten Sitzung oder sofort mit /reload-plugins. Seine Skills stehen dann im /-Menü als /formfeed:formfeed-templates und /formfeed:formfeed-api, auch wenn der Agent sie selbst lädt, wenn eine Aufgabe sie braucht, und Claude Code führt den Server als plugin:formfeed:formfeed, bis zur Anmeldung mit dem Hinweis, dass er auf die Authentifizierung wartet (siehe unten).

Claude Code aktualisiert ein Plugin aus diesem Marketplace nicht von selbst: Führen Sie claude plugin update formfeed@formfeed-dev aus, oder schalten Sie für formfeed-dev auf dem Tab Marketplaces von /plugin die automatische Aktualisierung ein. claude plugin uninstall formfeed@formfeed-dev entfernt das Plugin.

Cursor​

Installieren Sie den Server mit einem Klick über den Formfeed-Eintrag auf cursor.directory, oder tragen Sie ihn in ~/.cursor/mcp.json ein, wie die MCP-Seite zeigt. Die Skills kommen mit der Kommandozeile skills:

npx skills add formfeed-dev/skills

Sie fragt, für welche Ihrer Agenten sie installieren soll, und legt die Skills ins Projekt (.agents/skills) oder mit -g nach ~/.cursor/skills, für jedes Projekt.

Jeder andere Agent​

npx skills add formfeed-dev/skills installiert die beiden Skills für die Agenten, die die Kommandozeile skills kennt, darunter Codex, GitHub Copilot, Gemini CLI und Windsurf. --skill formfeed-templates installiert nur einen davon. Den Server fügen Sie in jedem Client auf dessen Weise hinzu; formfeed.dev/de/agents hat für jeden eine Anleitung.

Anmelden​

Zwei Dinge melden sich an, jedes für sich.

  • Der Server. Wenn der Agent sich zum ersten Mal verbindet, öffnet sich die Formfeed-Anmeldung im Browser (in Claude Code führen Sie /mcp aus und wählen den Server). Melden Sie sich an, wählen Sie den Workspace, in dem der Agent arbeitet, und erlauben Sie es. Was ein angemeldeter Agent darf und wie Sie seinen Workspace ändern oder ihn sperren, steht unter Anmeldung mit Ihrem Konto.
  • Die Kommandozeile, die die Skills ausführen. Führen Sie npx formfeed login selbst aus, das einen Live-Schlüssel mit den Scopes Ihrer Rolle speichert, oder speichern Sie einen Test-Schlüssel mit npx formfeed login ff_test_…, oder legen Sie einen in FORMFEED_API_KEY. Siehe Vorlagen als Code.

Die Skills fragen nie im Chat nach einem Schlüssel und schreiben nie einen in eine Datei.

Was der Agent selbst tut und wofür er fragt​

Die Skills halten den Agenten an diese Regeln:

  • init, validate, test, dev und einvoice laufen auf Ihrem Rechner und brauchen kein Konto. Dort arbeitet der Agent, bis die Vorlage stimmt.
  • Vor dem ersten Befehl, der die API aufruft, führt er formfeed whoami --json aus und sieht, welcher Schlüssel gilt. Ein Test-Schlüssel rendert kostenlos, im Free-Plan mit Testmarkierung. Ein Live-Schlüssel zählt jedes Rendering gegen die Einheiten Ihres Plans: Der Agent sagt es Ihnen, rendert einmal, wenn validate und test bestehen, und nie in einer Schleife.
  • Einen Befehl, der den Workspace ändert, den Ihr Team teilt, führt er nur aus, wenn das Gespräch darum gebeten hat: templates push, channels set, channels promote, channels rollback, channels delete, partials push, files push, files delete, renders delete-outputs, webhooks resend und workspaces delete.
  • Im Anwendungscode liest er den Schlüssel aus FORMFEED_API_KEY, schreibt nie einen Schlüssel in Code, eine Datei oder einen Commit und hält ihn auf dem Server.

Ein Skill ist eine Anleitung, der der Agent folgt, kein Schloss. Was geschehen kann, entscheidet der Schlüssel: Geben Sie dem Agenten einen Test-Schlüssel, solange er arbeitet, und behalten Sie den Live-Schlüssel für die CI und die Produktion. Über den Server rendert ein angemeldeter Agent immer live; verbinden Sie den Server stattdessen mit einem Test-Schlüssel, um beim Bauen kostenlos zu rendern.

Was es ausführt, sendet und lädt​

Das Plugin sammelt nichts. Die Skills führen die formfeed-CLI über npx aus, das sie von npm lädt, und die CLI sendet der Formfeed-API, was sie auch sendet, wenn Sie sie selbst ausführen. Die Adresse des Servers ist https://mcp.formfeed.dev/mcp. Die Quellen der Skills sind öffentlich in formfeed-dev/skills, unter der MIT-Lizenz.

Ohne das Plugin​

Für einen Agenten, der weder Plugins noch Skills liest, fügen Sie dieselbe Schleife in AGENTS.md oder CLAUDE.md ein: Der Ausschnitt steht auf formfeed.dev/agents.