Communitygithub.com

Instagram-Caption-Assistent

Optimierte Instagram-Bildunterschriften schreiben – inklusive des sichtbaren Teils, der Verkürzung, der Handlungsaufforderung, der Suchbegriffe und der Hashtags – und vor dem Posten linten. Nutze den Skill, wenn der User „Schreib die Bildunterschrift“, „Beschreib das“, „Was schreibe ich in die Beschreibung“ sagt, ein Reel oder Karussell fertig hat und den Text braucht oder nach Hashtags fragt.

Was ist Instagram-Caption-Assistent?

Dieser Skill analysiert, ob der Beitrag bereits durch das Video fesselt (Job A) oder die Bildunterschrift selbst als Hook dienen muss (Job B). Er generiert eine strukturierte Caption mit maximal 2.200 Zeichen, wobei die ersten 125 Zeichen sichtbar sind und als Box dargestellt werden. Der Skill unterstützt Claude Code und Codex und verwendet ein Python-Skript (`caption.py`) zum Linting. Dabei werden Regeln wie maximal ein Handlungsaufruf (Ask), maximal fünf spezifische Hashtags (seit Dezember 2025), kein Link im Caption-Text, Emoji-Quote unter 4 pro 100 Zeichen und die Integration von Suchbegriffen statt Hashtags durchgesetzt. Der Skill gibt einen fertigen Copy-Block mit einem Empfang (Receipt) aus, der Job, sichtbare Zeichen, Ask, Hashtags, Suchbegriffe und den Linter-Status zeigt. Der User klebt die Caption dann selbst in Instagram.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lodhaarihant/instagram-agent-arihant/tree/HEAD/skills/ig-caption

In Ihrer bevorzugten KI fragen

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

Dokumentation

Instagram-Bildunterschrift (ig-caption)

In diesem Ordner befindet sich ein Tool, das folgendermaßen ausgeführt wird:

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

Es gibt die Bildunterschrift so aus, wie sie im Feed erscheint: Die ersten 125 Zeichen in einer Box, der Rest hinter dem Tap. Lies diese Box, bevor du irgendetwas anderes liest, was du geschrieben hast.

Zuerst: Entscheide, welche Aufgabe diese Bildunterschrift hat

Das ist die Entscheidung, die Bildunterschriften ruiniert, wenn sie übergangen 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 Bildunterschrift ist kein zweiter Hook, und mit dem Video zu konkurrieren ist der Weg, beide zu verlieren. Ihre Aufgabe ist die Handlungsaufforderung (Ask), der Kontext, der die Handlungsaufforderung sinnvoll macht, und die Wörter, nach denen gesucht wird.

Aufgabe B: Die Bildunterschrift ist der Inhalt. Ein Foto, ein einzelnes Bild, ein Karussell-Cover, das eine Schleife öffnet. Hier ist Zeile 1 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 User ein Reel mit einem starken Hook hat, schreibe A und erkläre warum.

Die Struktur

Zeile 1      125 Zeichen sichtbarer Bereich. Aufgabe A: Die Handlungsaufforderung, klar.
             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
             Absätze. Hier leben die Suchbegriffe.
Der Ask      Einer. Kommentiere ein Keyword, speichere es oder schreib eine DM.
Hashtags     Maximal fünf, in einer eigenen Zeile ganz unten, oder gar keine.

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

Hashtags – ehrlich

Hashtags sind kein Reichweiten-Hebel mehr, und die Plattform hat das jetzt mit einer Produktänderung bestätigt. Instagram hat Hashtags am 18. Dezember 2025 auf fünf pro Beitrag gedeckelt (runter von dreißig) und den Creatorn mitgeteilt, dass „die Verwendung von weniger (bis zu fünf) gezielteren Hashtags statt vieler generischer“ besser abschneidet. Adam Mosseri hatte bereits im Februar 2025 gesagt, dass Hashtags nicht zur Reichweitensteigerung wirken und eher ein Label als ein Verteil-Hebel sind.

Also: maximal fünf, spezifisch, als Themen-Label. Wenn der User einen Block mit zwanzig in seiner Notizen-App gespeichert hat, ist dieser Block jetzt totes Gewicht, und der Linter wird ihn durchfallen lassen.

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

Suchbegriffe sind jetzt wichtiger als Hashtags

Die Instagram-Suche liest den Caption-Text. Deshalb kommt der Begriff, unter dem der User gefunden werden will, als Phrase, die ein Mensch tippen würde, in einem normal lesbaren Satz in die Bildunterschrift. „Kundenprojekte“ als Wörter in Zeile 3, nicht „#kundenprojekte“ in einem Block ganz unten.

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

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

Regeln

  • Kein Link in der Bildunterschrift. Bildunterschriften sind nicht klickbar. Eine URL im Text ist toter Text, der sagt „Ich nutze diese Plattform nicht“. Bio oder DM.
  • Eine Handlungsaufforderung. Zwei Fragen sind dasselbe wie keine. caption.py zählt sie.
  • Die Keyword-Ask braucht ein tippbares Keyword. Ein Wort, keine Leerzeichen, kein Emoji, und sprich es auch im Video laut aus. Kommentiere VERTRAG funktioniert. Kommentiere "der Vertragsguide" nicht.
  • Schreibe den ersten Kommentar separat, wenn es einen Link gibt. Sage das im Empfang (Receipt).
  • Emojis als Satzzeichen, nicht als Dekoration. Der Linter markiert alles über 4 pro 100 Zeichen.
  • Alternativtext ist 20 Sekunden wert. Für Karussells und Fotos: schreibe ihn. Er wird von Screenreadern und von Instagram gelesen.

Der Ablauf

  1. Entscheide Aufgabe A oder Aufgabe B und sage welche.
  2. Schreibe einen Entwurf.
  3. Führe /ig-human darauf aus. Bildunterschriften sind kurz, daher fällt Schrott hier lauter auf als anderswo im Set.
  4. Führe caption.py mit den Suchbegriffen des Users aus. Behebe jedes FAIL. Entscheide bei jedem WARN laut, nicht still.
  5. Gib den Copy-Ready-Block aus, dann den Empfang (Receipt):
CAPTION READY
job:        A – das Reel trägt den Hook
visible:    118 von 125 Zeichen verwendet vor dem Abschneiden
ask:        einer, kommentiere VERTRAG
hashtags:   3
search:     „Kundenprojekte“ in Zeile 3, „Agenturpreise“ in Zeile 5
linter:     READY

Es wird nichts gepostet. Der User fügt ein.

Individual skills in this repo

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

Verwandte Skills