Communitygithub.com

pierrernrd04-ai/traceo-reels

Schreibt die Instagram-Bildunterschrift – die Zeile, die den „… mehr“-Schnitt überlebt, den Text, die einzelne Aufforderung, die Suchbegriffe und die drei Hashtags – und lintet sie, bevor sie veröffentlicht wird. Verwende es, wenn der Benutzer sagt „Schreib die Caption“, „Beschrifte das“, „Was soll ich in die Beschreibung schreiben“, ein Reel oder Karussell bereit hat und den Text benötigt, oder nach Hashtags fragt.

Was ist traceo-reels?

Der Skill `ig-caption` ist ein spezialisiertes Werkzeug zum Erstellen und Optimieren von Instagram-Bildunterschriften, das als Teil eines KI-Agenten (z. B. Claude Code, Cursor oder Codex) fungiert. Er hilft dabei, Captions zu schreiben, die nicht nur den „… mehr“-Schnitt überleben, sondern auch die richtige Struktur für maximale Wirkung haben. Der Skill unterscheidet zwischen zwei Hauptaufgaben: Entweder trägt die Caption die Aufforderung (Ask) für ein Reel, das bereits durch das Video fesselt (Job A), oder sie ist selbst der Inhalt und muss mit einem starken Hook beginnen (Job B). Zusätzlich lintet der Skill die Caption mit einem Python-Skript, prüft auf Regelverstöße wie zu viele Hashtags (maximal fünf, da Instagram diese ab Dezember 2025 begrenzt), fehlende Suchbegriffe, zu viele Emojis oder doppelte Aufforderungen. Der Workflow umfasst die Entscheidung des Jobs, das Verfassen, das Linting mit dem Befehl `python3 caption.py` und die Ausgabe eines finalen Caption-Blocks mit einem Empfangsschein. Der Skill ist plattformunabhängig und kann in jeder Terminal-Umgebung eingesetzt werden, in der Python verfügbar ist.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pierrernrd04-ai/traceo-reels/tree/HEAD/studio/skills/ig-caption

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ig-caption

In diesem Ordner befindet sich ein Tool, das wie folgt ausgeführt wird:

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "Kundenprojekte,Agenturpreise"

Es gibt die Bildunterschrift so aus, wie der Feed sie anzeigt: die ersten 125 Zeichen in einem Kasten, alles andere hinter dem Tippen. Lies diesen Kasten, bevor du irgendetwas anderes liest, was du geschrieben hast.

Zuerst: Entscheide, welche Aufgabe diese Caption hat

Das ist die Entscheidung, die Captions ruiniert, wenn sie übersprungen wird.

Aufgabe A: Das Video hat sie bereits gefesselt. Ein Reel trägt seinen eigenen Hook in den ersten zwei Sekunden, gesprochen und auf dem Bildschirm. Die Caption ist kein zweiter Hook und mit dem Video zu konkurrieren bedeutet, beide zu verlieren. Ihre Aufgabe ist die Aufforderung (Ask), der Kontext, der die Aufforderung sinnvoll macht, und die Wörter, nach denen die Leute suchen.

Aufgabe B: Die Caption ist der Inhalt. Ein Foto, ein einzelnes Bild, ein Karussell-Cover, das einen Kreislauf öffnet. Hier ist Zeile eins der Hook und sie funktioniert genau wie ein Reel-Hook: konkret, kurz und an einer Klippe abgeschnitten, nicht mitten im Satz.

Frage, welche du schreibst. Wenn der Benutzer ein Reel mit einem starken Hook hat, schreibe A und erkläre warum.

Die Form

Zeile 1     125 Zeichen sichtbarer Bereich. Aufgabe A: die Aufforderung, klar und einfach.
             Aufgabe B: der Hook.
             Niemals eine Begrüßung, niemals ein Hashtag, niemals ein Emoji als erstes
             Zeichen.
Text        kurze Absätze, eine Leerzeile dazwischen. Zwei bis sechs
             davon. Hier leben die Suchbegriffe.
Der Ask     eine Aktion. Kommentiere ein Keyword, speichere es oder sende eine DM. Eine.
Hashtags    bis zu fünf, auf einer eigenen Zeile am Ende, oder gar keine.

Das Limit liegt bei 2.200 Zeichen, und fast nichts braucht 2.200. Eine Caption, die den Tippen verdient und dann 600 Zeichen liefert, schlägt eine, die 1.800 liefert.

Hashtags, ehrlich

Hashtags sind kein Reichweitenhebel mehr, und die Plattform hat das jetzt mit einer Produktänderung klargestellt. Instagram hat die Hashtags am 18. Dezember 2025 auf maximal fünf pro Beitrag begrenzt, von dreißig herunter, und den Erstellern mitgeteilt, dass „die Verwendung von weniger (bis zu 5) gezielteren Hashtags anstelle vieler allgemeiner“ besser abschneidet. Adam Mosseri hatte bereits im Februar 2025 gesagt, dass Hashtags nicht funktionieren, um die Reichweite zu erhöhen, und dass sie ein Label sind, kein Verteilungshebel.

Also: bis zu fünf, spezifisch, als Themen-Labels. Wenn der Benutzer einen Block von zwanzig in seiner Notizen-App gespeichert hat, ist dieser Block jetzt totes Gewicht, und der Linter wird ihn ablehnen.

#viral, #fyp, #explorepage, #foryou beschreiben nichts. Streiche sie.

Suchbegriffe sind jetzt wichtiger als Hashtags

Die Instagram-Suche liest den Caption-Text. Der Begriff, unter dem der Benutzer gefunden werden möchte, kommt also als Phrase in die Caption, wie ein Mensch sie tippen würde, in einem Satz, der normal klingt. „Kundenprojekte“ als Wörter in Zeile drei, nicht „#kundenprojekte“ in einem Block am Ende.

Frage nach zwei oder drei solcher Begriffe und übergib sie dann an den Linter:

python3 caption.py entwurf.txt --keywords "Kundenprojekte,Agenturpreise"

Regeln

  • Kein Link in der Caption. Captions sind nicht anklickbar. Eine URL im Text ist toter Text, der sagt: „Ich benutze diese Plattform nicht.“ Bio oder DM.
  • Eine Aufforderung. Zwei Aufforderungen sind so gut wie keine. caption.py zählt sie.
  • Die Keyword-Aufforderung braucht ein Keyword, das Leute tippen können. Ein Wort, keine Leerzeichen, kein Emoji, und sag es auch im Video laut. Kommentiere VERTRAG funktioniert. Kommentiere "der Vertragsleitfaden" nicht.
  • Schreibe den ersten Kommentar separat, wenn es einen Link gibt. Sage das in der Empfangsbestätigung.
  • Emoji als Interpunktion, nicht als Dekoration. Der Linter markiert alles über 4 pro 100 Zeichen.
  • Alt-Text ist 20 Sekunden wert. Für Karussells und Fotos schreibe ihn. Er wird von Bildschirmlesegeräten und von Instagram gelesen.

Der Ablauf

  1. Entscheide zwischen Aufgabe A oder Aufgabe B und sage, welche.
  2. Formuliere einen Entwurf.
  3. Führe /ig-human darauf aus. Captions sind kurz, daher ist Schlampigkeit hier lauter als irgendwo sonst im Paket.
  4. Führe caption.py mit den Suchbegriffen des Benutzers aus. Behebe jedes FEHLGESCHLAGEN. Entscheide laut über jedes WARNUNG, nicht stillschweigend.
  5. Gib den kopierfertigen Block aus, dann die Empfangsbestätigung:
CAPTION BEREIT
Aufgabe:    A – das Reel trägt den Hook
Sichtbar:   118 von 125 Zeichen vor dem Schnitt genutzt
Ask:        eins, kommentiere VERTRAG
Hashtags:   3
Suche:      "Kundenprojekte" in Zeile 3, "Agenturpreise" in Zeile 5
Linter:     BEREIT

Es wird nichts gepostet. Der Benutzer fügt es ein.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills