ig-caption

Que fait ig-caption ?

Un outil vit dans ce dossier et s'exécute avec :

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"

Il affiche la légende telle que le fil Instagram la présente : les 125 premiers caractères dans un encadré, tout le reste derrière le tapotement. Lisez cet encadré avant de lire quoi que ce soit d'autre que vous avez écrit.

Voix

Lisez ~/.claude/instagram/voice.md s'il existe et écrivez-y : les mots que l'utilisateur utilise réellement, ceux qu'il ne dirait jamais, comment il gère les emoji et les jurons, et la preuve qu'il est heureux d'apposer son nom. S'il n'existe pas, demandez deux ou trois publications qu'il a faites, déduisez-en la voix et proposez d'écrire le fichier pour que le prochain skill en dispose.

D'abord, décidez quel travail cette légende accomplit

C'est la décision qui ruine les légendes lorsqu'elle est ignorée.

Job A : la vidéo a déjà accroché le spectateur. Une Reel porte sa propre accroche dans les deux premières secondes, parlée et à l'écran. La légende n'est pas une seconde accroche et rivaliser avec la vidéo, c'est perdre sur les deux tableaux. Son travail est l'appel à l'action, le contexte qui donne du sens à cet appel et les mots que les gens recherchent.

Job B : la légende est le contenu. Une photo, une image unique, une couverture de carrousel qui ouvre une boucle. Ici, la première ligne est l'accroche et elle fonctionne exactement comme une accroche de Reel : concrète, courte et coupée sur un cliffhanger plutôt qu'au milieu d'une phrase.

Demandez lequel vous écrivez. Si l'utilisateur a une Reel avec une accroche forte, écrivez A et expliquez pourquoi.

La structure

Ligne 1     125 caractères d'espace visible. Job A : l'appel, simplement.
            Job B : l'accroche.
            Jamais une salutation, jamais un hashtag, jamais un emoji en premier
            caractère.
Corps       courts paragraphes, une ligne d'espace blanc entre chacun. Deux à six
            paragraphes. C'est là que résident les termes de recherche.
L'appel     un seul. Commentez un mot-clé, sauvegardez-le ou envoyez un MP. Un.
Hashtags    jusqu'à cinq, sur leur propre ligne en bas, ou aucun.

La limite est de 2 200 caractères et presque rien n'en nécessite 2 200. Une légende qui mérite le tapotement puis délivre 600 caractères bat une autre qui en délivre 1 800.

Hashtags, honnêtement

Les hashtags ne sont plus un levier de portée, et la plateforme l'a dit avec un changement de produit. Instagram a plafonné les hashtags à cinq par publication le 18 décembre 2025, contre trente auparavant, disant aux créateurs qu'« utiliser moins (jusqu'à 5) de hashtags plus ciblés, plutôt que de nombreux hashtags génériques » donne de meilleurs résultats. Adam Mosseri avait déjà dit en février 2025 que les hashtags ne fonctionnent pas pour augmenter la portée et qu'ils sont une étiquette, pas un levier de distribution.

Donc : jusqu'à cinq, spécifiques, comme étiquettes de sujet. Si l'utilisateur a un bloc de vingt enregistré dans son application de notes, ce bloc est désormais un poids mort et l'auditeur le signalera comme échoué.

#viral, #fyp, #explorepage, #foryou ne décrivent rien. Supprimez-les.

Les termes de recherche comptent plus que les hashtags maintenant

La recherche Instagram lit le texte de la légende. Donc, la phrase pour laquelle l'utilisateur veut être trouvé va dans la légende comme une phrase qu'un humain taperait, dans une phrase qui se lit normalement. « Client proposals » comme mots dans la troisième ligne, pas « #clientproposals » dans un bloc en bas.

Demandez deux ou trois de ces termes, puis passez-les à l'auditeur :

python3 caption.py draft.txt --keywords "client proposals,agency pricing"

Règles

• Pas de lien dans la légende. Les légendes ne sont pas cliquables. Une URL dans le corps est un texte mort qui dit « Je n'utilise pas cette plateforme ». Bio ou MP.
• Un seul appel. Deux appels équivalent à aucun. caption.py les compte.
• L'appel par mot-clé a besoin d'un mot-clé que les gens peuvent taper. Un mot, sans espaces, sans emoji, et dites-le à voix haute aussi dans la vidéo. Commentez CONTRAT fonctionne. Commentez "le guide du contrat" ne fonctionne pas.
• Rédigez le premier commentaire séparément s'il y a un lien. Mentionnez-le dans le reçu.
• Les emoji comme ponctuation, pas comme décoration. L'auditeur signale tout ce qui dépasse 4 pour 100 caractères.
• Le texte alternatif vaut 20 secondes. Pour les carrousels et les photos, rédigez-le. Il est lu par les lecteurs d'écran et par Instagram.

La boucle

1. Décidez Job A ou Job B et dites lequel.
2. Rédigez-le.
3. Lancez /ig-human dessus. Les légendes sont courtes, donc la médiocrité y est plus criante que partout ailleurs dans le pack.
4. Lancez caption.py avec les termes de recherche de l'utilisateur. Corrigez chaque ÉCHEC. Décidez pour chaque AVERTISSEMENT à voix haute plutôt qu'en silence.
5. Affichez le bloc prêt à copier, puis le reçu :

LÉGENDE PRÊTE
job:        A - la reel porte l'accroche
visible:    118 des 125 caractères utilisés avant la coupure
appel:      un, commentez CONTRAT
hashtags:   3
recherche:  "client proposals" ligne 3, "agency pricing" ligne 5
auditeur:  PRÊT

Rien n'est publié. L'utilisateur le colle.