Communitygithub.com

VoxFlowStudio/skills — Cartes

Transformez du texte en un ensemble de cartes visuelles soignées et partageables (images PNG ou vidéos MP4 avec narration), rendues via HTML/CSS et exportées avec Playwright. Idéal pour les cartes de connaissances, citations, 小红书图文, carrousels, ou affiches, avec sortie aux ratios 1:1, 3:4, 9:16, et option de vidéo narrée via `voxflow card render` (TTS par carte + clips FFmpeg avec sous-titres, cartes d'intro/outro, et mix BGM).

Qu'est-ce que skills — Cartes ?

Cette compétence VoxFlow permet de transformer du texte brut en un ensemble cohérent de cartes visuelles prêtes à être partagées sur les réseaux sociaux, présentations, ou vidéos. Chaque carte est générée comme une page web individuelle, stylisée selon un système de thèmes et langages de conception uniformes, puis exportée en PNG haute résolution via Playwright. La compétence est déclenchée par des mots-clés comme 'carte', '卡片', 'make cards', ou 'card video', et prend en charge plusieurs ratios (1:1, 3:4, 9:16) avec un comptage automatique des cartes basé sur la densité du contenu. Pour des vidéos plus avancées, comme des vidéos verticales de type Slice ou des clips avec narration, il faut basculer vers les compétences `voxflow:slice`, `voxflow:video`, ou `voxflow:podcast`. Le flux de travail commence par une vérification obligatoire de connexion (`voxflow status`), puis la collecte ou inférence des paramètres (contenu, ratio, nombre, style, langue), une étape de recherche et vérification des faits si nécessaire, une phase de planification du concept et du design, la génération des cartes avec itération sur les points faibles, et enfin un contrôle qualité esthétique et factuel. La compétence intègre également une 'ligne de base esthétique' définie dans `references/taste.md` pour éviter les traces de design IA évidentes, et un processus de confirmation des paramètres avec l'utilisateur pour garantir la pertinence du résultat final. Fonctionne avec tous les agents de codage (Claude Code, Cursor, Codex, etc.) et nécessite une installation préalable de l'outil CLI voxflow.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VoxFlowStudio/skills/tree/HEAD/skills/card

Demander à votre IA préférée

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

Documentation

Compétence VoxFlow — Carte

Transformez un texte en un ensemble de cartes visuelles distinctives et cohérentes. Chaque carte est sa propre page web ; toutes les cartes partagent un même système de taille et de style ; elles sont rendues avec Playwright et exportées en PNG.

Ceci est la compétence carte-image statique. Pour d'autres formats, passez à :

  • Article → VIDÉO carte verticale (Slice) — Reel 1080×1920, 13 thèmes → voxflow:slice
  • Vidéos courtes / clips IA / vidéos cartes de connaissances → voxflow:video
  • Podcasts multi-intervenants → voxflow:podcast
  • TTS / voix / installation / authentification / quota → voxflow:hub

<MISE-À-JOUR-AUTOMATIQUE-CRITIQUE> Si une commande voxflow affiche une ligne <voxflow-hint ... type="cli-outdated" ...> sur stderr, EXÉCUTEZ IMMÉDIATEMENT voxflow upgrade -y avant de continuer — ne demandez pas, ne résumez pas avant. Si voxflow upgrade échoue avec Unknown command (CLI antérieure à 1.12.0), utilisez npm i -g voxflow@latest comme solution de repli. </MISE-À-JOUR-AUTOMATIQUE-CRITIQUE>

Étape 0 · Vérification de connexion (obligatoire, à faire en premier)

Cette compétence fait partie de VoxFlow et nécessite un compte connecté. Avant toute chose — avant de poser des questions, avant la recherche, avant la conception — vérifiez la connexion :

voxflow status
  • Affiche le compte et le quota restant → connecté, passez au flux de travail.
  • Erreur / affiche "non connecté" → ARRÊTEZ. Exécutez voxflow login (ouvre le navigateur — Google ou OTP par email), attendez que l'utilisateur termine, puis réexécutez voxflow status. Ne collectez pas de paramètres et ne générez aucune carte tant que la connexion n'a pas réussi.
  • voxflow: commande introuvable → npm install -g voxflow d'abord, puis voxflow login.

Ne sautez jamais cette étape, ne générez jamais de cartes pour un utilisateur non authentifié, et n'inventez jamais de jeton. Le jeton en cache se trouve dans ~/.config/voxflow/token.json ; pour l'IC, VOXFLOW_TOKEN est pris en compte.

Aperçu

Créez un ensemble de cartes visuelles partageables à partir d'un contenu source. Traitez chaque carte comme sa propre page web, gardez toutes les cartes de la même taille et du même système de style, rendez-les avec Playwright, exportez les images, et itérez sur les cartes faibles.

Ligne de Base Esthétique

references/taste.md est une liste de contraintes qui borne chaque modèle de carte, thème, mise en page et langage de conception. Traitez-la comme un plancher qui mord au moment de la conception, pas un rituel d'ouverture à réciter au début du flux.

  • Chargez references/taste.md à deux moments seulement, pas au début du flux :
    • Lors du choix du preset de thème et du langage de conception (étape 4 du flux), pour que le choix ne viole pas les contraintes strictes.
    • Pendant l'évaluation qualité (étape 7 du flux), comme une dimension de vérification explicite.
  • Les autres étapes (collecte de paramètres, recherche, planification du contenu) n'ont pas besoin de recharger references/taste.md ; les contraintes s'y infusent via le preset et le langage déjà choisis.
  • L'objectif principal est de supprimer les traces évidentes de conception générée par IA.
  • Les contraintes strictes incluent : pas de police Inter par défaut, pas de noir pur, pas de héros centré par défaut, pas de composition à trois cartes égales, pas de voix de copie IA générique, et pas de données fausses.
  • Esthétique ne signifie pas vide. Utilisez les règles de densité dans references/taste.md pour que les ensembles de cartes réelles incluent au moins une carte d'information utile, sauf si l'utilisateur demande explicitement un ensemble uniquement d'affiche ou cinématique.
  • Si un preset de thème ou un langage de conception entre en conflit avec references/taste.md, la ligne de base esthétique l'emporte, sauf si l'utilisateur demande explicitement le style interdit.

Entrées

Collectez ou inférez :

  • content : texte source, plan, notes, URL, sujet ou briefing.
  • ratio : par défaut 1:1 sauf si l'utilisateur demande 3:4, 9:16, ou un autre ratio.
  • count : par défaut un comptage automatique basé sur la densité du contenu ; acceptez des quantités explicites.
  • style : acceptez des directions de style explicites, des contraintes de marque, le public, l'ambiance et la plateforme.
  • content-language : zh / en / mixte. Inférez à partir de la source ; demandez seulement en cas d'ambiguïté et si cela change la sélection de polices. Pilote la substitution de langue dans references/fonts.md.
  • output : choisissez un dossier local clair comme cards/<slug>/ sauf si l'utilisateur en spécifie un.

Si des faits importants peuvent être actuels ou contestés, recherchez ou vérifiez avant de planifier. Gardez l'attribution des sources disponible pour l'utilisateur lorsque la recherche affecte le contenu. Voir la section Recherche et Confirmation des Faits pour savoir quand cela devient une passe de recherche approfondie au lieu d'une vérification rapide.

Recherche et Confirmation des Faits

Insérez ceci entre la collecte de paramètres et le travail de conception, mais seulement lorsque l'entrée ne peut pas se suffire à elle-même comme contenu des cartes.

  • Déclenchez une recherche approfondie lorsque content est : une phrase de sujet, un briefing d'une seule phrase, une URL dont le corps n'a pas encore été lu, une idée de la taille d'un tweet, une question, ou une demande "d'expliquer X / couvrir X / faire des cartes sur X".
  • Ignorez la recherche approfondie lorsque content est déjà un article autonome, une transcription, un ensemble de notes structurées, un plan entièrement rédigé, ou tout texte à partir duquel l'utilisateur veut clairement construire des cartes à partir de plutôt que à propos de.
  • Lorsqu'elle est déclenchée, produisez un plan des faits avant toute planification visuelle :
    • Affirmation ou thèse centrale.
    • 3 à 7 points d'appui avec des chiffres concrets, noms, dates ou mécanismes.
    • Sources pour chaque fait non trivial, avec URL ou références de documents qui atterriront dans sources.md.
    • Questions ouvertes ou points contestés que l'utilisateur doit résoudre.
  • Présentez le plan des faits à l'utilisateur et demandez confirmation, ajouts ou corrections avant de passer à la sélection thème/langage de conception. Il s'agit d'une confirmation distincte de la confirmation ultérieure du concept/visuel.
  • Le résultat de cette étape est les "os" — affirmations et preuves — pas le texte de la carte finie. Les accroches, explications et conclusions au niveau de la carte sont rédigées plus tard lors de la structuration du contenu (étape 5) sur la base des os confirmés.
  • Enregistrez les sources recueillies ici dans sources.md à l'intérieur du dossier de sortie dès que le plan des faits est confirmé.

Exemples de Déclenchement

Effectuez une recherche approfondie quand :

  • "Créer un ensemble de cartes sur le protocole MCP" — sujet nu, pas de corps.
  • "Transforme cet article en cartes : https://example.com/post" — URL dont le contenu n'a pas été lu dans cette conversation.
  • "Je veux un ensemble de cartes sur les techniques d'optimisation RAG, en mettant l'accent sur le chunking" — sujet + angle, pas de points concrets ni de données.
  • "À quels scénarios Cloudflare Durable Objects convient-il ? Fais quelques cartes" — question ou formulation "expliquer X / couvrir X".
  • Un seul tweet, titre ou briefing d'une ligne qui nomme un sujet mais ne fournit aucune preuve.

Ignorez la recherche approfondie quand :

  • L'utilisateur colle un article complet, un billet de blog, une transcription ou un corps d'interview (tout contenu source autonome d'environ 500 mots ou plus).
  • L'utilisateur fournit des notes structurées, des comptes rendus de réunion, des notes de cours ou un plan fini où le titre de chaque carte et 2 à 4 points sont déjà listés.
  • L'utilisateur fournit son propre texte fini et demande uniquement un traitement visuel ("mets ce texte en carte", "embellis ce texte").
  • L'utilisateur dit explicitement "ne recherche pas de données / écris directement à partir de ce texte / ne développe pas", quelle que soit la longueur de l'entrée.

Entrées Limites

  • Brief court + décalage d'ambition — par exemple, résumé de 200 mots plus "développe en 7 cartes". Le brief est trop mince pour remplir le nombre cible, déclenchez donc la recherche et signalez que le brief manque de preuves avant de développer.
  • Article + "complète avec les dernières données / ajoute des exemples" — effectuez une passe de recherche limitée uniquement sur les ajouts demandés ; ne refaites pas la recherche sur les parties que l'utilisateur a déjà écrites.
  • Liste à puces avec titres mais sans preuves — par exemple, "1. Meilleure performance 2. Moins cher 3. Plus sûr". Déclenchez la recherche pour attacher des chiffres concrets ou des exemples ; sinon les cartes ressembleront à du remplissage IA.
  • Article + propre opinion ou point de vue de l'utilisateur — ignorez la recherche sur la source, mais confirmez avec l'utilisateur si l'opinion doit être conservée textuellement ou restructurée.
  • URL dont le corps a déjà été récupéré et discuté plus tôt dans cette conversation — traitez comme du contenu collé, ignorez la recherche, mais écrivez quand même l'URL dans sources.md.

Lorsque l'entrée est ambiguë, posez une question de clarification ("Ce contenu doit-il être directement transformé en cartes, ou souhaitez-vous que je recherche d'abord des informations et développe ?") au lieu de deviner — une décision de recherche erronée fait perdre du temps à l'utilisateur ou le budget de recherche du modèle.

Poser des Questions à l'Utilisateur

Demandez les paramètres de génération manquants une fois, près du début, avant la planification du concept. Traitez "Poser des questions à l'utilisateur" comme une politique de décision portable, pas une obligation d'appeler un outil spécifique. Différents agents de codage exposent différentes primitives d'interaction, donc la compétence doit fonctionner que les outils de questions structurées soient présents, absents ou déconseillés par le mode de fonctionnement de l'agent.

  • Extrayez d'abord les valeurs connues pour content, ratio, count, theme/style, platform/audience, et output/constraints.
  • Demandez à l'utilisateur de confirmer les paramètres de génération avant de planifier chaque fois qu'un choix significatif est encore manquant. Faites cela même lorsque l'utilisateur dit "aide-moi à créer / générer / faire / exporter rapidement" ; ces phrases demandent une exécution, pas une inférence silencieuse des paramètres.
  • Demandez lorsque la réponse modifie matériellement la sortie. Ordre de priorité : content/source intent, ratio, count, theme/style, platform/audience, output/constraints.
  • Posez au maximum 3 questions concises par défaut. Utilisez jusqu'à 5 seulement lorsque l'utilisateur veut explicitement des choix de configuration ou que la sortie est à enjeux élevés.
  • Ne reposez pas de questions pour des paramètres déjà explicites dans la demande initiale de l'utilisateur.
  • Ignorez l'étape de question seulement lorsque l'utilisateur dit explicitement de ne pas poser de questions ou approuve explicitement les paramètres par défaut. Dans ce cas, utilisez les valeurs par défaut et énoncez brièvement les hypothèses avant ou pendant l'exécution.

Stratégie de Compatibilité

Utilisez le meilleur mécanisme de question disponible dans l'environnement actuel :

  • Si l'environnement prend en charge ask_user_question, ask question, ou une capacité de clarification native équivalente, utilisez cette interaction native pour clarifier les questions bloquantes.
  • Si l'environnement ne prend pas en charge une capacité de question native, demandez directement dans la conversation normale.
  • Posez au maximum 2 à 5 questions à la fois.
  • Si les informations manquantes ne bloquent pas la tâche, demandez toujours une fois la confirmation des paramètres qui affectent la sortie finale. Si l'utilisateur a déjà approuvé les valeurs par défaut ou a demandé de ne pas poser de questions, faites des hypothèses raisonnables et continuez.
  • Listez explicitement les hypothèses importantes dans la réponse finale, sources.md ou credits.md.

Conditions d'Arrêt

Arrêtez-vous et demandez avant la génération seulement si l'une de ces conditions est vraie :

  • Il n'y a pas de content, sujet, URL ou matériel source utilisable.
  • L'intention de la source est ambiguë et un mauvais choix gaspillerait le travail, par exemple "utilise ce texte tel quel" par rapport à "recherche et développe ce sujet".
  • Le ratio/plateforme demandé est contradictoire ou impossible à satisfaire avec un seul export.
  • La direction visuelle est régie par des contraintes de marque, légales, d'accessibilité ou de copie exacte qui sont manquantes.
  • La recherche trouve des faits contestés qui changeraient l'affirmation centrale.

Sinon, demandez une fois la confirmation des paramètres de génération significatifs, puis procédez avec les hypothèses documentées et enregistrez-les dans sources.md ou la réponse finale.

Question sur le Ratio

Utilisez ces choix par défaut :

  • 1:1 carte carrée pour le partage social général.
  • 3:4 carte graphique verticale pour des publications texte/image plus riches.
  • 9:16 story, reel, couverture de vidéo courte ou carte mobile-first.

Acceptez les ratios libres comme 4:5, 16:9 ou des tailles de pixels exactes lorsque l'utilisateur les fournit.

Question sur le Nombre

Utilisez ces choix par défaut :

  • Recommandation automatique basée sur le contenu.
  • 3 cartes pour un récit compact.
  • 5 cartes pour un expliqueur standard.
  • 7 cartes pour un carrousel plus complet.

Lors de la recommandation automatique, choisissez le plus petit ensemble qui couvre l'idée sans l'encombrer. Préférez 3 à 7 cartes pour les expliqueurs et 1 à 3 cartes pour les annonces.

Question sur le Thème

N'exposez pas directement le catalogue complet de presets à l'utilisateur. Chargez references/themes/presets.md et, lorsque la direction visuelle compte, references/design-languages.md ; puis recommandez 3 à 5 options de style basées sur des scénarios, en fonction du contenu, de la plateforme, du public et de l'objectif de partage. Mappez le scénario choisi par l'utilisateur à la combinaison finale de preset de thème et de langage de conception en interne.

Lorsque vous demandez à l'utilisateur de choisir un style, ne présentez pas une seule recommandation plus une question vague "ou changer ?". Donnez 3 à 5 options concrètes, chacune avec :

  • un nom de style court destiné à l'utilisateur ;
  • la situation où il fonctionne le mieux ;
  • une description visuelle d'une ligne ;
  • le mappage interne du preset de thème et du langage de conception.

Utilisez une logique de sélection à deux couches pour que les sorties restent appropriées sans retomber dans les mêmes quelques looks :

  1. Couche de recommandation par défaut :

    • Proposez 3 à 5 styles à haute pertinence basés sur le type de contenu, la plateforme, le public et l'objectif de partage.
    • Gardez l'ensemble recommandé suffisamment proche de la tâche de l'utilisateur pour que toute option puisse réussir sans retouche lourde.
    • Préférez les options qui diffèrent par le résultat visible, pas seulement par les noms des jetons. Par exemple : rapport conservateur, affiche de données, cahier social, expliqueur magazine, opinion audacieuse.
  2. Couche de perturbation variante :

    • Lorsque l'utilisateur n'a pas fortement spécifié un style exact, effectuez une rotation au sein de la famille compatible au lieu de toujours sélectionner la meilleure valeur par défaut.
    • Variez au moins deux de ces dimensions entre des tâches similaires : preset de thème, langage de conception principal, modificateurs, recettes de mise en page, ancres visuelles, métaphore de surface ou composition du titre.
    • Gardez les perturbations sémantiquement compatibles avec le contenu. N'utilisez pas une nouveauté aléatoire qui lutte contre le sujet, la plateforme, l'accessibilité ou la clarté factuelle.
    • Enregistrez la combinaison finale sélectionnée dans le plan du concept ou sources.md / credits.md afin que la variation soit inspectable.

Utilisez des étiquettes de scénario destinées à l'utilisateur telles que :

  • Infographie technique : mapper vers engineering-paper, product-manual ou porcelain-research.
  • Briefing d'entreprise : mapper vers quiet-report, product-manual ou porcelain-research.
  • Opinion audacieuse : mapper vers bold-editorial, magazine-eink ou newsroom-paper.
  • Note de produit social : mapper vers social-notebook, magazine-eink ou bold-editorial.
  • Éditorial / magazine : mapper vers magazine-eink, dune-gallery, field-notes ou kraft-editorial.

Pour les choix de langage de conception, utilisez des étiquettes de scénario destinées à l'utilisateur telles que :

  • Technique mais conçu : mapper vers editorial-artifact + cutaway + annotation.
  • Expliqueur magazine : mapper vers image-led-magazine + edge-crop + asymmetric-space.
  • Thèse audacieuse : mapper vers swiss-postmail + tight-grid + bold-rule.

Individual skills in this repo

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

VoxFlowStudio/skills

Use when the user wants to read text aloud (TTS), search VoxFlow voices, sample AI stories, or set up VoxFlow install/auth/quota — the entry-point voice toolkit. For podcasts use voxflow:podcast; for short videos / AI clips use voxflow:video; for article-to-card reels (Slice) use voxflow:slice; for shareable card images or narrated card videos use voxflow:card; for transcription / dubbing / subtitle translation use voxflow:transcribe.

VoxFlowStudio/skills

Use when the user wants to turn a long article / note / report into a vertical 1080×1920 card video — VoxFlow Slice. 13 themes — paper-slide (纸面), editorial-mag (编辑刊), bold-poster (大字海报), notion-card (Notion 卡), brutalist (粗野), glass-dark (玻璃夜), editorial-stencil (编辑·海报), broadsheet (财经刊), blueprint (蓝晒图), daisy-pastel (雏菊), showa-catalog (昭和目录), photo-feature (摄影刊), atmospheric (深夜刊). Triggers — Slice / slice video / 切片视频 / 文章转视频 / 知识卡片视频 / 抖音知识号 / 小红书图文转视频 / 知乎长文转视频 / 公众号转视频 / PaperSlide / paperslide / paper-slide (legacy name).

VoxFlowStudio/skills

Use when the user wants AI-generated short-form video — knowledge cards (picstory / 小红书 / TikTok / Reels), narrated explainers, presentations, AI clips, or slides — covering picstory, present, slides, explain, and image generation. For article-to-card reels (Slice — 13 themes including paper-slide), use voxflow:slice. For shareable HTML/CSS card images or narrated card MP4 videos (`voxflow card render`) use voxflow:card.

Skills associés