Communitygithub.com

simpletibr/simplicio-loop-marketing

Assemble une invite de génération vidéo en sélectionnant le fournisseur via PROVIDERS.md et en déléguant au constructeur spécifique correspondant.

Qu'est-ce que simplicio-loop-marketing ?

Ce skll est un répartiteur générique et indépendant du fournisseur pour les invites de génération vidéo. Il lit la matrice de routage dans `.specs/architecture/PROVIDERS.md`, détermine quel fournisseur doit exécuter la tâche (Higgsfield, Topview, Wavespeed, Hyperframes), et délègue au constructeur spécialisé correspondant. Il est utile car il centralise le choix du fournisseur pour tous les pipelines vidéo (du brief à la création), gère les surcharges par pièce, les tests A/B entre fournisseurs, et la sélection automatique basée sur le type de tâche (`cinematic_reel`, `ugc_product_holder`, etc.). Le processus inclut la validation des variables d’environnement, la traduction des champs du brief vers le format attendu par chaque spécialiste, et l’appel MCP final ou le mode dry-run pour inspection. Il prend en charge les skills spécialisés `higgsfield-prompt-builder`, `topview-prompt-builder`, `wavespeed-batch` et `hyperframes-prompt-builder`, et journalise chaque exécution dans `data/video-usage.jsonl`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/video-prompt-builder

Demander à votre IA préférée

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

Documentation

Video Prompt Builder

Répartiteur générique et indépendant du fournisseur pour les invites de génération vidéo. Lit la matrice de routage dans .specs/architecture/PROVIDERS.md, décide quel fournisseur doit exécuter la pièce, et délègue au spécialiste approprié (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).

Quand invoquer

  • Toute étape de génération vidéo dans le pipeline (brief -> script -> creative lorsque le type créatif est vidéo).
  • Lorsqu’une pièce déclare type: video dans .specs/pieces/*.md.
  • Tests A/B de hooks vidéo entre fournisseurs et lorsque l’orchestrateur a besoin d’un point d’entrée unique.
  • Relancer le même brief sur un fournisseur différent après qu’un gagnant A/B a été choisi.
  • Lorsqu’un agent en amont a un brief mais ne sait pas quel fournisseur choisir.

Entrées

  • brief: objet. Brief visuel avec au moins subject, motion, mood, aspect, duration_seconds.
  • task_kind: chaîne. L’un des suivants : cinematic_reel, motion_control, ugc_product_holder, product_demo, talking_head, batch_hook_test, motion_typography, data_viz_reel, programmatic_short.
  • piece_path: chaîne, optionnelle. Chemin vers le fichier de la pièce. Peut contenir provider_override.video.
  • dry_run: booléen, optionnel. Lorsqu’il est vrai, retourne le fournisseur résolu et les paramètres sans appeler le MCP.

Processus

  1. Lire .specs/architecture/PROVIDERS.md et analyser la matrice Vidéo en une correspondance task_kind -> provider.
  2. Si piece_path est défini et contient provider_override.video, utiliser la surcharge.
  3. Sinon, rechercher task_kind dans la matrice. Si inconnu, utiliser la valeur par défaut de la matrice pour cinematic_reel.
  4. Vérifier que le fournisseur choisi a les variables d’environnement définies (HIGGSFIELD_MCP_ACTIVE, TOPVIEW_API_KEY, WAVESPEED_API_KEY, HYPERFRAMES_ACTIVE).
  5. Mapper le fournisseur au skill spécialiste : Higgsfield -> higgsfield-prompt-builder, Topview -> topview-prompt-builder, Wavespeed -> wavespeed-batch, Hyperframes -> hyperframes-prompt-builder.
  6. Traduire les champs du brief dans la forme d’entrée attendue par le spécialiste.
  7. Invoquer le spécialiste et capturer ses params et sa sortie mcp_tool.
  8. Si dry_run, retourner le fournisseur résolu, les paramètres et l’outil MCP. Sinon, appeler le MCP et retourner la référence de l’artefact.
  9. Journaliser l’exécution dans data/video-usage.jsonl avec l’horodatage, le fournisseur, le task_kind et le résultat.

Sorties

  • provider_used: chaîne.
  • params: objet. Objet de paramètres final prêt pour l’appel MCP.
  • mcp_tool: chaîne. Le nom de l’outil MCP.
  • artifact_ref: chaîne, sauf en mode dry_run. Chemin ou URL de la vidéo générée.
  • cost_estimate_usd: nombre.

Exemples

Exemple 1 : reel cinématographique routé vers Higgsfield

Entrée : { brief: { subject: "model in linen suit", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" } Sortie : { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }

Exemple 2 : publicité UGC routée vers Topview

Entrée : { brief: { subject: "skincare bottle held by avatar", motion: "static", mood: "friendly", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" } Sortie : { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }

Exemple 3 : reel KPI hebdomadaire routé vers Hyperframes

Entrée : { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" } Sortie : { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — rendu local via les skills hyperframes + hyperframes-cli.

Modes de défaillance

  • task_kind non présent dans la matrice : journaliser un avertissement et utiliser la valeur par défaut cinematic_reel.
  • Variable d’environnement requise manquante pour le fournisseur choisi : passer au fournisseur suivant dans la matrice et afficher un avertissement.
  • Le skill spécialiste retourne une erreur : l’afficher et ne pas réessayer automatiquement sur un autre fournisseur sauf si l’appelant le demande.
  • La durée dépasse la limite du fournisseur : réduire à la durée maximum du fournisseur et afficher un avis.

Skills associés

  • higgsfield-prompt-builder : spécialiste pour Soul, DoP, Seedance.
  • topview-prompt-builder : spécialiste pour les publicités UGC et pilotées par avatar.
  • wavespeed-batch : spécialiste pour les tests de hook batch bon marché.
  • hyperframes-prompt-builder : spécialiste pour la typographie animée en HTML, les reels de visualisation de données et les courts métrages paramétrés programmatiques.
  • llm-router : répartiteur séparé pour la génération de texte ; même modèle, domaine différent.
  • qa-tech-specs : valide la vidéo finale par rapport aux spécifications de la plateforme.

Individual skills in this repo

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

Skills associés