Gib deinem Coding-Agent mit PiPic Skill einen Bildkompressor

Dein Coding-Agent kann einen Build ausführen, eine Komponente bearbeiten und einen fehlgeschlagenen Test reparieren. Bittest du ihn jedoch, einen Bilderordner zu komprimieren, schreibt er oft ein Wegwerfskript oder wählt ein Werkzeug, dessen Ausgabe er nicht zuverlässig deuten kann. PiPic bietet einen anderen Weg: Eine echte CLI erledigt die Bildarbeit, und ein kurzer Skill bringt dem Agent bei, diese CLI sicher aufzurufen.

PiPic ist kein KI-Kompressionsmodell. Der Agent wählt und bedient das Werkzeug; die PiPic Agent CLI sendet PNG-, JPEG-, WebP- oder AVIF-Dateien an denselben gehosteten Kompressionsdienst wie die HTTP API. PiPic Skill ist die Anleitungsebene, die eine natürlich formulierte Aufgabe mit dem Befehl verbindet.

CLI und Skill einmal installieren

Die Person, die den Rechner nutzt, übernimmt die Einrichtung. Installiere die CLI, bestätige eine Anmeldung und füge den Open-Source-Skill zu deinen Agents hinzu:

npm i -g @pipic/cli
pipic login

npx skills add PiPic-cc/pipic-cli -g \
  -a claude-code \
  -a codex \
  -a cursor \
  -y

Der kürzere Befehl npx skills add PiPic-cc/pipic-cli -g fragt, welche unterstützten Agents den Skill erhalten sollen. Mit npx skills update -g lassen sich später Aktualisierungen für global installierte Skills prüfen. Der Skill-Quelltext ist zusammen mit der CLI öffentlich. Die Betriebsregeln stecken damit nicht verborgen in einem Prompt-Dienst.

Danach braucht die Anfrage weder den Produktnamen noch irgendwelche Flags:

Compress the images in ./assets in place.

Die Beschreibung des Skills passt zu Aufgaben, in denen Bilder komprimiert, verkleinert oder optimiert werden sollen. Nach der Auswahl prüft er, ob pipic installiert und der Rechner angemeldet ist. Dann ordnet er “in place” dem Flag --replace zu und startet die CLI mit maschinenlesbarer Ausgabe:

pipic ./assets --replace --json

Sollen die Originale erhalten bleiben, verwendet der Agent stattdessen -o <dir>. PiPic verlangt genau eines dieser Ziele und lehnt einen Befehl ohne Ziel ab, bevor eine Datei gesendet wird.

Der Skill trägt Regeln, die ein Agent nicht erraten kann

Ein README kann einen Befehl beschreiben. Der Agent muss trotzdem entscheiden, was als Erfolg gilt, wann er einen Versuch wiederholt und wann er aufhört. Diese Entscheidungen betreffen Dateien und das Monatskontingent, deshalb hält PiPic Skill sie ausdrücklich fest.

Der Skill weist den Agent an, immer --json anzufordern. Die CLI schreibt daraufhin pro Eingabedatei ein NDJSON-Objekt mit sechs festen Feldern: file, status, before, after, saved und bei übersprungenen oder fehlgeschlagenen Dateien error. status kennt nur ok, skipped und error.

skipped ist kein Fehlschlag. Häufig war das komprimierte Ergebnis größer, deshalb behielt PiPic das Original. Der Skill verhindert, dass der Agent dies als kaputten Lauf meldet oder eine gute Datei durch eine größere ersetzt.

Der Exit-Code bestimmt die nächste Aktion:

Die Regel für Exit-Code 1 ist wichtig. Wird nach zwei Fehlern das ganze Verzeichnis erneut ausgeführt, lädt die CLI alle bereits erfolgreichen Dateien noch einmal hoch und verbraucht das Kontingent doppelt. Der Skill beschränkt die Wiederholung auf die fehlgeschlagenen Pfade.

Auch für Versionsabweichungen gibt es einen Ausweg. Wenn sich die installierte CLI anders verhält als im Skill beschrieben, führt der Agent pipic --help aus und folgt dem tatsächlich installierten Programm. Der Skill kann unabhängig aktualisiert werden; zur Laufzeit bleibt die ausführbare Datei maßgeblich.

Die CLI erledigt die Bildarbeit

Der Skill enthält keinen Encoder, lädt keine Bildbytes hoch und komprimiert selbst nichts. Er bringt dem Agent bei, die CLI aufzurufen. Die CLI löst die Pfade auf, prüft das Ziel, ruft den gehosteten Dienst auf, schreibt kleinere Ergebnisse atomar und gibt die Zeilen aus, die der Agent liest.

Ein veröffentlichter Lauf aus unserem Benchmark für das dritte Quartal 2026 verarbeitete landscape.png mit PiPic Agent CLI 1.0.6. Die aufgezeichnete Datei war vorher 2.316.198 Byte und danach 723.577 Byte groß, eine Ersparnis von 1.592.621 Byte. Das ist ein lizenziertes Testbild in einem aufgezeichneten Lauf, kein Versprechen für jedes PNG. Der Benchmark veröffentlicht die Eingaben, exakten Befehle, alle 72 Rohzeilen und seine Einschränkungen.

Für eine normale Agent-Aufgabe ist der Vertrag um diese Zahl herum entscheidend. Der Agent kann erklären, welche Datei geändert wurde, wie viele Byte gespart wurden, welche Dateien unverändert blieben und ob ein Pfad Aufmerksamkeit braucht. Er muss weder eine Fortschrittsanimation noch einen für Menschen geschriebenen Satz deuten.

Der Remote-MCP-Endpunkt ist von diesem Ausführungspfad getrennt. Er ist ein schreibgeschützter Integrationsleitfaden, der Agents beim Entdecken von CLI und HTTP API hilft. Bildbytes laufen durch die CLI oder eine direkte HTTP-Anfrage, nicht durch JSON-RPC.

Die Grenze zum Menschen bleibt ausdrücklich

Der Agent installiert nie selbstständig ein globales Paket und führt pipic login nicht selbst aus. Eine globale Installation verändert die Benutzerumgebung. Die Anmeldung öffnet einen Browser oder wartet auf einen Gerätecode, den nur der Benutzer bestätigen kann. Beendet sich pipic whoami mit Code 3, hält der Agent an und bittet um diese Bestätigung.

Die von pipic login gespeicherten Zugangsdaten gelten für spätere Agent-Läufe auf demselben Rechner. Ein Container, CI-Job oder eine Sandbox sieht das ~/.config des Benutzers möglicherweise nicht. Dort wird stattdessen ein vom Benutzer auf der Kontoseite erzeugtes PIPIC_TOKEN gesetzt.

PiPic CLI und API haben ein eigenes Monatskontingent: 100 Bilder im Free-Tarif und 5.000 im Pro-Tarif. Der Browser-Kompressor bleibt kostenlos, unbegrenzt und ohne Konto nutzbar. CLI-Bilder verlassen den Rechner zur Verarbeitung und werden direkt nach Abschluss der Kompression vom Server gelöscht; die Datenschutzseite beschreibt die vollständige Verarbeitung.

Die Aufgabenteilung ist klar. Der Mensch installiert und autorisiert das Werkzeug. Der Skill liefert die Betriebsregeln, der Agent entscheidet über den Aufruf, und die CLI erledigt die Arbeit mit einem Ausgabevertrag, dem der Agent tatsächlich folgen kann.