Communitygithub.com

voice-builder

Ce skill guide l'utilisateur à travers une interview structurée et une analyse d'échantillons d'écriture pour produire deux fichiers de profil (about-me.md et voice.md) qui capturent la voix unique d'un auteur.

Qu'est-ce que voice-builder ?

Voice Builder est un skill conçu pour les agents d'IA comme Codex ou Claude, qui aide les utilisateurs à définir et documenter leur voix d'écriture personnelle ou professionnelle. Le processus commence automatiquement dès le chargement, sans préambule, par une interview en deux lots de questions à choix multiples sur l'identité, le public cible, les sujets de prédilection et les angles de vue. Une fois les réponses collectées, le skill génère un fichier `about-me.md` synthétique (moins de 300 mots). Ensuite, l'utilisateur fournit au moins 3 échantillons de contenu écrit (posts LinkedIn, newsletters, essais, etc.) ; le skill les analyse en profondeur, identifiant des signaux de voix (longueur de phrase, rythme, ton, phrases signatures), des motifs structurels et d'absence. Le résultat est un fichier `voice.md` complet (moins de 500 mots) qui décrit la voix positive et les éléments à éviter. Le skill insiste sur la priorité aux preuves fournies, le respect des fichiers utilisateur existants, et l'interdiction d'inventer des schémas non présents. Fonctionnant sur Codex et Claude, il s'adapte aux outils disponibles et évite toute publication, envoi de messages ou modification de comptes sans autorisation explicite.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlie947/social-media-skills/tree/main/skills/voice-builder

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Voice Builder

Environnements Codex et Claude

  • Utilisez ce skill dans Codex ou Claude avec les outils effectivement disponibles dans la tâche en cours. Les exemples AskUserQuestion décrivent les questions, pas une API obligatoire : utilisez un outil de question disponible dans ses limites, ou posez les questions dans le chat. Réutilisez les réponses et les sources déjà fournies.
  • Travaillez dans le projet sélectionné par l'utilisateur. Lisez son fichier about-me.md, voice.md et les fichiers de marque pertinents avant tout travail personnalisé. Confirmez l'auteur prévu si les fichiers sont en conflit ou contiennent des valeurs par défaut. Demandez les informations manquantes ou exécutez voice-builder ; n'héritez jamais de l'identité, des comptes ou des fichiers privés du mainteneur.
  • Résolvez les references/ fournies par rapport à ce dossier de skill. Pour une actualisation de profil explicitement demandée, lisez et mettez à jour les fichiers canoniques about-me.md, voice.md ou newsletter-voice.md sur place, en préservant les faits et règles utilisateur non liés. Les consommateurs doivent relire ces fichiers canoniques. Utilisez un nouveau nom de fichier uniquement pour les nouvelles livraisons qui entreraient en conflit avec des fichiers existants non liés. L'installation seule ne démarre jamais une interview ou n'écrit pas de fichiers. N'écrivez pas d'apprentissages persistants sauf si demandé.
  • Utilisez d'abord les preuves fournies. Vérifiez les affirmations externes via les outils de recherche/source disponibles lorsque nécessaire. Si une source ou une intégration est indisponible, nommez la capacité manquante et proposez la saisie de texte ou d'exportation fournie. N'inventez jamais de faits, d'expériences à la première personne, de métriques ou d'exécution réussie d'outil.
  • Connectez uniquement les services nécessaires à la voie choisie via le compte existant de l'utilisateur. N'imprimez jamais d'identifiants et n'écrasez pas de connexions. La rédaction, la sauvegarde et la révision n'autorisent pas la publication, l'envoi de messages ou la modification de comptes.

CRITIQUE : Démarrage automatique au chargement

Lorsque l'utilisateur demande ce workflow, commencez à l'étape 1. Cela signifie que votre tout prochain message à l'utilisateur est constitué des questions de l'interview. Rien d'autre.

Ne faites PAS :

  • Résumer ce skill
  • Décrire les fichiers qu'il crée
  • Expliquer son fonctionnement
  • Dire « voici ce que contient ce skill »
  • Demander si l'utilisateur veut l'exécuter
  • Confirmer l'installation
  • Proposer des options comme « voulez-vous que je lance ceci maintenant ? »

Faites CECI :

  • Allez directement à l'étape 1
  • Envoyez les questions de l'interview comme votre première et unique réponse

Cela s'applique lorsque l'utilisateur demande à construire sa voix ou fournit des échantillons à cette fin. Pas de préambule. Pas de résumé. Interview d'abord.

Étape 1. Mener l'interview « About Me »

Posez les questions en suivant les directives d'exécution ci-dessus. Si un outil de question est disponible, respectez son schéma et ses limites de lot ; sinon, posez les mêmes questions dans le chat.

AskUserQuestion prend en charge un maximum de 4 questions par appel, donc envoyez deux appels : Lot 1 d'abord, attendez les réponses, puis Lot 2.

Lot 1 (votre toute première action, aucun texte avant)

Utilisez ces questions, en adaptant le schéma de l'outil si nécessaire :

[
  {
    "question": "Quel est votre nom et que faites-vous ?",
    "header": "À propos de vous",
    "multiSelect": false,
    "options": [
      {"label": "Fondateur", "description": "Je dirige ma propre entreprise ou cabinet de conseil"},
      {"label": "Responsable marketing", "description": "Je dirige le marketing dans une entreprise"},
      {"label": "Créateur", "description": "Je crée du contenu comme activité principale"},
      {"label": "Responsable commercial", "description": "Je dirige une équipe commerciale ou le développement des affaires"}
    ]
  },
  {
    "question": "Pour qui écrivez-vous ?",
    "header": "Public",
    "multiSelect": false,
    "options": [
      {"label": "Fondateurs et dirigeants", "description": "Décideurs qui dirigent des entreprises"},
      {"label": "Marketeurs", "description": "Professionnels du marketing à tous les niveaux"},
      {"label": "Chercheurs d'emploi", "description": "Personnes à la recherche de leur prochain poste"},
      {"label": "Autres professionnels", "description": "Un groupe totalement différent"}
    ]
  },
  {
    "question": "Quels sont les 3 à 5 sujets pour lesquels vous souhaitez être connu ?",
    "header": "Sujets",
    "multiSelect": true,
    "options": [
      {"label": "IA et automatisation", "description": "Comment les outils d'IA transforment le travail"},
      {"label": "Marketing", "description": "Stratégie, contenu, croissance"},
      {"label": "Leadership", "description": "Management, recrutement, culture"},
      {"label": "Marque personnelle", "description": "Construire une audience et une réputation"}
    ]
  },
  {
    "question": "Quel est votre point de vue sur votre secteur, cette chose que vous croyez et que les autres ne croient pas ?",
    "header": "Avis tranché",
    "multiSelect": false,
    "options": [
      {"label": "La plupart des conseils sont erronés", "description": "Le consensus dans votre secteur est défaillant"},
      {"label": "Les gens compliquent les choses", "description": "La réponse est plus simple que ce que les gens pensent"},
      {"label": "Un grand bouleversement arrive", "description": "Quelque chose est sur le point de changer et la plupart des gens ne sont pas prêts"}
    ]
  }
]

Lot 2 (envoyez immédiatement après le retour des réponses du Lot 1, sans commentaire entre les deux)

Appelez à nouveau AskUserQuestion avec :

[
  {
    "question": "Quelle est la seule chose que vous voulez que les gens pensent lorsqu'ils voient votre nom ?",
    "header": "Promesse de marque",
    "multiSelect": false,
    "options": [
      {"label": "Cette personne est pragmatique", "description": "Elle me donne des choses que j'utilise immédiatement"},
      {"label": "Cette personne est honnête", "description": "Elle me dit ce que les autres ne diront pas"},
      {"label": "Cette personne est en avance", "description": "Elle voit ce qui arrive avant tout le monde"}
    ]
  },
  {
    "question": "Quelle est la seule chose sur laquelle vous refusez d'écrire ?",
    "header": "Interdit",
    "multiSelect": false,
    "options": [
      {"label": "Politique", "description": "Aucune prise de position politique, jamais"},
      {"label": "Vie personnelle", "description": "Restez uniquement professionnel"},
      {"label": "Concurrents", "description": "Ne nommez ni ne critiquez d'autres personnes ou marques"}
    ]
  }
]

Après que les deux lots ont été répondus, passez à l'étape 2. Si une réponse est vide ou ignorée, reposez cette question spécifique une fois de plus dans le chat, puis passez à autre chose.

Étape 2. Écrire about-me.md

Créez about-me.md à la racine du projet. Utilisez cette structure :

# À propos de moi

## Nom et rôle
[D'après la question 1]

## Public
[D'après la question 2, développé en 2 à 3 phrases sur qui est le lecteur]

## Piliers thématiques
[3 à 5 sujets de la question 3, une ligne chacun]

## Point de vue
[D'après la question 4, la conviction opposée ou distinctive, rédigée comme une déclaration claire]

## Promesse de marque
[D'après la question 5, la pensée unique que l'auteur souhaite posséder dans l'esprit du lecteur]

## Interdits
[D'après la question 6, les sujets ou angles sur lesquels il ne faut jamais écrire]

Gardez-le sous 300 mots. Chaque ligne doit être quelque chose que l'assistant pourrait référencer en écrivant.

Étape 3. Demander les échantillons

Dites ceci :

Collez maintenant 3 à 5 textes dont vous voulez que j'apprenne. Il peut s'agir de posts LinkedIn, de numéros de newsletter, d'essais, d'articles de blog, d'e-mails, de tweets ou de tout autre écrit que vous avez publié. Ils peuvent être les vôtres ou ceux de quelqu'un dont vous admirez la voix. Un texte par message ou tous en même temps. Si vous n'avez pas d'échantillons prêts, tapez « utiliser échantillons » et je chargerai un ensemble de démarrage que vous pourrez remplacer plus tard.

Attendez que l'utilisateur colle. Minimum 3 échantillons avant de passer à l'analyse. S'il en colle moins de 3, demandez-en plus.

Si l'utilisateur tape « utiliser échantillons », chargez le texte depuis references/sample-content.md dans ce dossier de skill. Dites à l'utilisateur de quel auteur proviennent les échantillons afin qu'il sache quelle voix il emprunte. Rappelez-lui qu'il peut les remplacer plus tard par ses propres écrits.

Étape 4. Analyser les échantillons

Lisez chaque échantillon. Cherchez des motifs à travers tous, pas des bizarreries individuelles d'un seul texte. Extrayez :

Signaux de voix

  • Longueur moyenne des phrases
  • Rythme des paragraphes (sauts de ligne simples, lignes vides, style saccadé ou fluide)
  • Style d'accroche ou d'ouverture (contraire, question, donnée, histoire, confession, observation)
  • Point de vue (première personne, deuxième personne, observationnel)
  • Ton (pince-sans-rire, chaleureux, direct, ludique, clinique)
  • Phrases signatures ou mots récurrents
  • Style d'appel à l'action ou de conclusion

Signaux structurels

  • Plage de longueur
  • Listes par rapport à la prose
  • Comment ils ouvrent, comment ils ferment
  • Comment ils gèrent les transitions

Signaux thématiques

  • Sujets qui reviennent dans plusieurs échantillons
  • Qui semble être le public
  • Ce que l'auteur défend

Signaux d'absence

  • Mots et ponctuation systématiquement absents (par exemple, tirets cadratins dans 0 échantillon sur 5)
  • Types d'accroche que l'auteur n'utilise jamais
  • Tonalités que l'auteur n'atteint jamais
  • Structures que l'auteur évite

Étape 5. Écrire voice.md

Créez voice.md à la racine du projet. Il s'agit d'un profil intégré unique couvrant à la fois la manière dont la voix écrit et ce que la voix évite. Pas de fichier vocal séparé.

# Profil vocal

## À qui je ressemble
[2 à 3 phrases décrivant la voix globale en langage clair]

## Ton
[3 à 5 attributs que la voix atteint systématiquement, suivis de 1 à 2 tonalités que la voix n'atteint jamais, tirées des lacunes des échantillons]

## Rythme des phrases
[Longueur moyenne, rythme, structure des paragraphes. Inclure les motifs d'évitement : par exemple, jamais de fragments saccadés, jamais de tricolons, aucune phrase de plus de 25 mots]

## Modèles d'accroche
[3 à 5 types d'accroche observés, avec un exemple chacun tiré des échantillons. Noter les types d'accroche absents de tous les échantillons, par exemple, jamais de questions rhétoriques, jamais « imaginez un monde où »]

## Comment j'ouvre
[1 à 2 phrases. Noter les mouvements d'ouverture que la voix évite si un motif clair d'évitement existe dans les échantillons]

## Comment je ferme
[1 à 2 phrases, inclure le style d'appel à l'action. Noter les mouvements de fermeture que la voix évite, par exemple, jamais de résumés motivants, jamais « en conclusion »]

## Phrases signatures
[Mots ou expressions récurrents des échantillons]

## Interdits
[Mots, ponctuation ou constructions absents de chaque échantillon. Ne lister que les éléments que les échantillons évitent clairement. Exemples : pas de tirets cadratins (0 échantillon sur 5), pas de hashtags, pas de jargon d'entreprise nommé]

## Ce que cette voix ne fait jamais
[3 à 5 comportements spécifiques tirés des lacunes des échantillons. Soyez précis. Si les échantillons n'utilisent jamais la construction « pas X, mais Y », listez-la. S'ils évitent un ensemble de vocabulaire spécifique, nommez ces mots]

Remplissez chaque section à partir des échantillons réels. Pas de remplissage générique. Si un motif n'est pas présent, dites-le. Ne dupliquez pas le public ou les piliers thématiques de about-me.md.

Séparez les interdictions explicites de l'utilisateur des motifs simplement absents dans ce petit échantillon. Étiquetez ces derniers comme provisoires, avec le nombre d'échantillons ; l'absence seule n'établit pas une interdiction permanente. Les échantillons de démarrage décrivent un style emprunté, jamais les expériences ou la voix établie de l'utilisateur.

Étape 6. Confirmer et passer la main

Dites à l'utilisateur :

Votre profil vocal est construit. Deux fichiers se trouvent désormais dans votre projet : about-me.md et voice.md. Ces skills lisent les deux fichiers lorsqu'ils sont invoqués dans ce projet ; une nouvelle tâche doit découvrir les skills et utiliser le même contexte de projet. Vous pouvez ouvrir et modifier l'un ou l'autre fichier à tout moment.

Vous êtes prêt. Voici ce que vous pouvez faire ensuite :

  • Dites « construis ma voix de newsletter » pour créer des instructions d'écriture spécifiques à la newsletter
  • Dites « écris un post » pour rédiger un post LinkedIn dans votre voix
  • Dites « conçois un graphique » pour créer un visuel pour un post
  • Dites « évalue mon post » pour obtenir des commentaires sur un brouillon
  • Dites « optimise mon profil » pour reconstruire votre profil LinkedIn

Chacune de ces actions est un skill séparé. Choisissez-en un et lancez-vous.

Ce que ce skill produit

Deux fichiers à la racine du projet :

  1. about-me.md : qui est l'utilisateur, son public, ses piliers thématiques, son point de vue
  2. voice.md : le profil vocal intégré, couvrant les signaux positifs (comment la voix écrit) et les signaux d'absence (ce que la voix évite) dans un seul document

Règles

  • Lorsque ce skill se déclenche, allez directement à l'étape 1. Pas de résumé, pas d'explication, pas de préambule.
  • Sortez toujours le contenu des échantillons dans un bloc de code afin que l'utilisateur puisse copier-coller le format exact sans perdre les sauts de ligne ou les espaces blancs. Utilisez un bloc de code simple (triple backticks sans étiquette de langage).
  • Travaillez à partir de ce qui se trouve dans les échantillons. N'inventez pas de motifs qui ne sont pas là.
  • Minimum 3 échantillons pour la détection de motifs. Demandez-en plus s'il y en a moins de 3.
  • Si les échantillons se contredisent, notez la contradiction dans voice.md plutôt que de la lisser.
  • Gardez about-me.md sous 300 mots.
  • Gardez voice.md sous 500 mots.
  • Anglais britannique tout au long, sauf si les échantillons sont clairement américains.
  • N'utilisez jamais de tirets cadratins dans aucun fichier de sortie ou dans aucun brouillon.
  • Ne créez pas de profil d'absence séparé. Les signaux d'absence résident dans voice.md.

Individual skills in this repo

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

Skills associés