tianbester-ZA/script

/bb:script

Objectif

Un shoot pack que l’équipe peut filmer en un après-midi. Chaque publicité arrête un étranger en deux secondes, son coupé, donne à une personne une raison d’acheter et se termine sur une offre qu’elle peut actionner. Derrière, une feuille de raisonnement nomme le passage du livre sous chaque accroche, promesse et preuve.

Commencez ici : lisez, reformulez, demandez une fois

La personne qui exécute ce skill détient le contexte, et ce qu’elle dit ici est ce qui rend le travail bon. Une de nos publicités a échoué parce que rien n’a été demandé ; un reel a fonctionné parce que quelqu’un a donné un vrai contexte.

Lisez d’abord, ne demandez pas : les gagnants du client, ses personas, ses avis et ses publicités passées ; le produit, le prix et l’offre en direct ; ce qui a été dit dans le brief.

Reformulez : l’acheteur, l’angle, le stade, l’offre, tels que vous les lisez dans les preuves. Remplissez ce que vous savez, pour qu’ils confirment plutôt que de retaper.

Ne demandez que ce qui manque, en un seul tour court (AskUserQuestion si vous l’avez, sinon dans le message). Généralement deux ou trois :

1. Qui cette publicité doit-elle émouvoir, que doivent-ils s’imaginer, et que doivent-ils faire immédiatement après avoir regardé ?
2. Quel produit, offre, prix, raison d’agir et preuve exacts pouvons-nous montrer aujourd’hui ? Qu’est-il vraiment arrivé à la personne qui parle ?
3. Qui parle, comment doit-il sonner, et que pouvons-nous réellement filmer : caméra, personnes, lieu, accessoires, temps ?

Proposez ensuite où elle se situe, pour un oui ou une modification : acheteur × angle × stade de conscience, le mode de script (histoire du fondateur, réponse à un commentaire réel, démonstration, problème mené, comparaison équitable, défi sur le terrain ou divertissement, offre directe) et le format.

Mettez les réponses dans job/brief.md, puis travaillez jusqu’au bout sans vous arrêter. S’ils ont déjà tout donné, ou disent simplement « allez-y », ne demandez pas. Si personne ne peut répondre (exécution sans tête), dites ce que vous auriez demandé et prenez la lecture raisonnable.

Le goût appartient au travail

Écrivez le travail sur la première ligne de job/brief.md : publicité payante, reel organique, ou ce que le tour d’ouverture a défini. Ce que quelqu’un a aimé dans une vidéo ne s’applique pas à une autre. Un reel organique et une publicité sont des travaux différents : la publicité est faite pour vendre. Donc une publicité est jugée sur son public, les arguments de vente du produit, la preuve et une raison d’acheter, pas sur les blagues ou l’ambiance d’un contenu organique. Une blague ne mérite sa place dans une publicité que si elle porte la vente.

Pourquoi ce skill existe

Laissé seul, Claude écrit des publicités polies : une personne face caméra, une accroche parlée douce qui exige de connaître la star, une petite blague, l’offre dite deux fois, la même conclusion à chaque fois. Propre, tournable et plat. Les modèles dérivent vers le choix sûr et commun, et une liste de règles ne les en ramène pas.

Ce qui fonctionne : trouver l’attrait avant les mots, faire plusieurs accroches avant de choisir, avoir la note du livre sous les yeux, et laisser un critique qui n’a jamais vu votre raisonnement juger le brouillon. Les livres sont des questions et des passages, jamais des voix. « Écris comme Schwartz » ne fait rien. « Ce spectateur est froid, donc la première ligne le décrit-elle plutôt que le produit ? » avec le passage derrière, oui.

À quoi ressemble un bon résultat

• Cinq publicités qui ne partagent pas la même forme. Lisez l’ordre et vous ne pouvez pas prédire la pub 4 à partir de la pub 1.
• Un premier plan et une ligne de texte qu’un inconnu comprend en muet, avec peu de mots. La caméra peut être un personnage et la blague de fin peut être un regard. Toutes les idées ne sont pas des talking heads, et toutes ne se terminent pas par quelqu’un tombant dans une piscine.
• Rapide et clair sur le public cible et la raison d’achat, et chaque publicité se termine sur une offre. Les sketches sont les bienvenus quand le brief demande du fun, et doivent toujours vendre : la blague est l’argument de vente, et la raconter nécessite le produit.
• Dirigeable : « Fais ça. Fais ça. Dis ça. » Le décor le plus simple qui porte l’idée, généralement un seul endroit et le moins de personnes possible.
• Une offre par publicité, dite une fois, à la fin, exactement, en douze mots ou moins, formulée dans sa forme vraie la plus forte.
• Des chiffres exacts et des détails nommés au lieu d’adjectifs, chacun tracé jusqu’à son propriétaire.
• Elle parle à une personne et change une croyance qu’elle détient. Un produit qui défile dans de belles images est une vitrine, aussi jolie soit-elle, et échoue.
• Un pack qui ressemble exactement au format livré, sans citations, sans questions ouvertes et sans rien marqué comme non confirmé.

Commandes

Les fichiers de référence écrivent ces commandes en abrégé. L’état du shell ne se transmet pas entre les commandes, utilisez donc toujours la forme complète, et donnez la forme complète à l’agent critique également.

• scripts/... signifie ${CLAUDE_SKILL_DIR}/scripts/.... references/... signifie ${CLAUDE_SKILL_DIR}/references/....
• search.py signifie python3 "${CLAUDE_PLUGIN_ROOT}/skills/books/scripts/search.py".
• Fiches des livres : ${CLAUDE_PLUGIN_ROOT}/skills/books/cards/.

Le chemin

Travaillez dans <client>-scripts/<aaaa-mm-jj>-<slug>/ dans le dossier où se trouve la personne, ou le dossier nommé par le brief (job/). Chaque étape écrit quelque chose, donc une session redémarrée reprend depuis le dernier fichier.

0. Lisez, d’abord le client. Le tour d’ouverture ci-dessus, fait correctement : les gagnants du client et leurs chiffres, ses personas, et les mots de ses clients (avis, commentaires de pub), partout où ses notes pointent. « Aucun enregistré » signifie que vous n’avez pas encore regardé. Ensuite, toutes les notes du client ou son skill de profil, son propre dossier de gagnants (ce client uniquement, voir examples/README.md), lessons.md, le brief. Re-vérifiez les prix, les offres et les dates auprès de leurs propriétaires. Écrivez job/brief.md : faits et offres avec source et date, qui est à l’écran, ce que seule cette marque a, les idées du client une par ligne, les réponses du tour d’ouverture.

1. Diagnostiquez. Chargez references/diagnose.md. Commencez par une personne réelle : un nom pour son type, sa journée, ce qu’elle utilise maintenant, ce qu’elle dirait, pourquoi elle et pas les autres personas, avec les preuves. Ensuite, déterminez l’attrait, ce qu’ils font maintenant, leur niveau de conscience, combien de fois ils ont entendu le message, ce qu’ils ne croient pas, pourquoi l’offre existe et ce que seule cette marque a. Écrivez reasoning.md §1, un bloc par emplacement.

2. Cherchez dans les livres pour ce travail. Chargez references/search.md. Ne partez pas de votre mémoire de ce que disent les livres : effectuez six à dix recherches sur les problèmes réels de ce produit, lisez les notes avec --show, gardez huit à douze passages qui concernent ce brief. Écrivez reasoning.md §2 : id, une ligne, quel emplacement.

3. Accroches. Chargez references/hooks.md. Six à huit par publicité, d’au moins quatre types, dont une simple et au moins deux étranges que vous hésiteriez à montrer au client. Gardez-en trois : une sûre, une étrange, une qui ne mentionne pas l’offre. Écrivez reasoning.md §3. Faites les options même quand personne n’est là pour les voir : choisissez, et laissez les options écartées dans la feuille.

4. Brouillon. Chargez references/body-and-close.md, references/offer-and-proof.md et references/pack-format.md. Écrivez job/pack-draft.md. Écrivez reasoning.md §4 : par publicité, une ligne pour l’accroche, la promesse, la preuve, le corps et la conclusion, chacun avec son passage.

5. Vérifiez.

python3 "${CLAUDE_SKILL_DIR}/scripts/check_pack.py" job/pack-draft.md --event "Black Friday"
python3 "${CLAUDE_SKILL_DIR}/scripts/cite_check.py" job/reasoning.md

Corrigez chaque ligne rouge. Les lignes ambrées sont des jugements. Sauvegardez la sortie dans job/checks.txt.

6. Critique. Lancez un nouvel agent sur le modèle le plus fort disponible avec pack-draft.md, brief.md, references/critic.md, la commande complète search.py (et, pour une édition, les fiches de rushes). Pas reasoning.md, pas ce chat : il juge la publicité par rapport au travail dans le brief, pas par rapport à l’excuse. Ses questions nomment de vrais passages et il lit leurs notes. Il retourne des notes, jamais une réécriture. Sauvegardez comme job/critic.md.

7. Réécrivez. Lisez la note derrière chaque passage cité par le critique avant d’agir : certains identifiants concernent en fait autre chose, et une note peut quand même être juste dans sa propre logique. Là où le brief l’emporte, contestez par écrit dans reasoning.md §5. Relancez l’étape 5. Un tour, deux au maximum. Le résultat est job/pack.md.

8. Empaquetez.

python3 "${CLAUDE_SKILL_DIR}/scripts/build_pack.py" job/pack.md --pdf

Ouvrez le PDF et regardez chaque page : rien de coupé, une publicité par page. Lisez les lignes warning:. Dans la réponse, donnez une ligne par publicité et une phrase nommant les livres une fois. Si le client a un journal, ajoutez une ligne datée.

Ce qui est réglé est réglé

Les faits que la personne a réglés sont réglés. Personne ne veut un pack qui liste des choses comme non confirmées, ou une page de petites questions. Donc ne faites pas cela : prenez la lecture raisonnable, écrivez-la dans reasoning.md §0 avec une ligne expliquant pourquoi, et passez à autre chose. Mettez ce qu’ils ont confirmé dans la ligne settled: du pack, que le vérificateur respecte. Si un chiffre n’a vraiment pas de propriétaire, écrivez la publicité sans lui, et enregistrez-le.

Seul ce qui changerait une décision ou un contact client est soulevé, comme une ligne simple dans la réponse. Un nombre que vous ne pouvez pas sourcer n’est jamais inventé, et n’apparaît jamais non plus comme une question.

Éditer des images qui existent déjà

Parfois le travail est des mots pour des images déjà filmées, pas un tournage. Même chemin, trois différences. L’étape 0 part des images : listez les moments utilisables par clip et par timestamp, puisque le script ne peut promettre que ce qui a été filmé. L’étape 1 ajoute une vérification des images : pour chaque affirmation, nommez le moment du clip qui la montre, et réécrivez ou abandonnez une affirmation sans plan. Sur la page, mettez mode: edit dans le front matter : les lignes Say contiennent les mots à l’écran, la conclusion est un texte à l’écran, la section film est ## Les images. Remettez le pack à /bb:edit.

Limites strictes

• Un seul client par travail. Aucune information d’un autre client n’entre dans le brief, le pack ou la feuille, et aucune information d’un client n’entre dans ce skill.
• Pas de chiffres, délais, stocks ou avis inventés. L’urgence n’est que ce qui est vrai et a une raison.
• Le texte des livres reste à l’extérieur. Dites ce qu’un livre enseigne dans vos propres mots et citez l’identifiant.
• Rien n’est envoyé à un client, publié ou dépensé depuis ce skill sans l’accord de la personne. Le pack va à la personne qui exécute ce skill ; c’est elle qui l’envoie.

Savoir-faire

Mots par seconde. 2,5 mots parlés par seconde : 15 s correspondent à environ 35 mots, 20 s à environ 50, 30 s à environ 75, 60 s à environ 150. Les actions prennent aussi du temps.

Les livres ne parlent pas des reels. Ce sont l’imprimé, la vente par correspondance, la télévision et des études en laboratoire. Traitez les chiffres comme ce qui a ému les gens à l’époque. Ceux d’Hormozi sont ses propres affirmations ; beaucoup de ceux de Cialdini concernent des faveurs, pas des achats. Rien dans ces livres ne teste un flux muet. La grammaire muette, la caméra comme personnage et les gags de fin viennent du visionnage de vrais reels, c’est donc là qu’il faut regarder : les propres références du client, et tout ce que la personne a envoyé.

Là où les livres se contredisent. Chaque référence se termine par les désaccords et la direction que nous prenons pour une vidéo de 15 à 60 secondes. Nommez la direction dans la feuille quand elle décide d’une publicité.

Un vote est un test d’opinion. Les critiques et les juges préfèrent le malin ; les split-runs souvent non (caples-0221, caples-0279). Donc une accroche simple est filmée comme une option supplémentaire même si le critique n’est pas impressionné, et les chiffres en direct la départagent.

Accroche et rétention. Taux d’accroche = lectures à 3 secondes ÷ impressions. Taux de rétention = ThruPlays ÷ lectures à 3 secondes. Accroche inférieure à environ 20 % : re-coupez uniquement l’ouverture. Rétention inférieure à environ 40 % : re-coupez le milieu. Les deux sains et pas d’achats : l’offre ou la conclusion, pas le montage.

Chargez ces fichiers quand

Référence	Quand
references/diagnose.md	Étape 1, et quand un script semble plat sans raison identifiable
references/search.md	Étape 2, ou quand une recherche ne donne rien
references/hooks.md	Étape 3, et pour tout travail de « ré-accrochage » d’une publicité
references/body-and-close.md	Étape 4
references/offer-and-proof.md	Étape 1 pour le fossé de croyance et la raison de l’offre ; étape 4
references/pack-format.md	Étape 4 et étape 8
references/critic.md	Seulement l’agent critique (étape 6)
examples/README.md	Étape 0, pour trouver les gagnants d’un client
evals/judge.md	Seulement pour les tests en aveugle entre deux packs

Leçons

lessons.md contient des puces datées issues de résultats réels : la publicité, le nombre avec sa date, le passage derrière le beat, ce qui a été essayé. Lisez les cinq dernières à l’étape 0 ; le critique vérifie le brouillon par rapport à elles. Ce dossier est remplacé à chaque mise à jour, donc les propres leçons et gagnants d’un client vont dans son dossier, et une leçon pour tout le monde passe par le dépôt (CONTRIBUTING.md).