Communitygithub.com

simpletibr/simplicio-loop-marketing

Skill d'amorçage en un coup qui intègre HyperFrames (https://github.com/wesleysimplicio/hyperframes) dans un clone de marketing-engine en tant que fournisseur vidéo de première classe — les trois skills d'exécution, la classe fournisseur + mock, les lignes de la matrice de routage, les variables d'environnement et les mises à jour de CLAUDE.md. Idempotent. À invoquer lorsqu'un clone frais a besoin d'HyperFrames, ou lors de la réapplication de l'intégration après un rebase qui en a supprimé une partie.

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

Ce skill automatise en une seule passe l'intégration d'HyperFrames, un renderer HTML vers MP4, en tant que fournisseur vidéo dans un clone de marketing-engine. Il suit strictement le contrat « Ajout d'un nouveau fournisseur » défini dans CLAUDE.md, garantissant une intégration complète et cohérente. Le skill crée les trois skills d'exécution (hyperframes, hyperframes-cli, hyperframes-prompt-builder), étend la couche fournisseur (types, matrice de routage, classes réelles et mock), met à jour le fichier de matrice de routage (.specs/architecture/PROVIDERS.md) et les variables d'environnement (.env.example), et modifie CLAUDE.md. Il est entièrement idempotent : réexécuté sur un dépôt déjà intégré, il ne touche à aucun fichier. Le skill supporte les tâches de motion typography, data-viz reel, et programmatic short, et peut être exécuté en mode dry-run pour prévisualiser les changements. Il s'intègre avec l'écosystème Claude Code ou tout agent utilisant SKILL.md.

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

Demander à votre IA préférée

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

Documentation

Installer HyperFrames

Reproduit, en une passe, l'intégration qui ajoute HyperFrames en tant que fournisseur vidéo en suivant le contrat en trois étapes Ajout d'un nouveau fournisseur dans CLAUDE.md. Liste de contrôle autonome de chaque artefact qui doit exister ; vérifie chacun et crée uniquement ce qui manque.

Exécutez ce skill au lieu de redériver l'intégration à partir de zéro. C'est l'enregistrement canonique de ce que signifie « HyperFrames est câblé » dans ce dépôt.

Quand invoquer

  • Clone frais de marketing-engine qui n'a pas encore de support HyperFrames.
  • Un rebase ou une fusion a supprimé l'un des artefacts ci-dessous (router:check se plaint, le routage vidéo retombe sur higgsfield pour les tâches de typographie, ou .skills/hyperframes*/ sont manquants).
  • Un nouveau client souhaite des courts métrages programmatiques / typographie animée / bobines de visualisation de données et la matrice a besoin des trois types de tâches câblés.
  • Onboarding d'un nouvel opérateur qui a besoin d'un playbook exécutable par commande unique au lieu de trois commits à lire.

Entrées

  • repo_root : chaîne. Chemin absolu vers le clone de marketing-engine. Par défaut process.cwd().
  • branch : chaîne, optionnelle. Branche sur laquelle effectuer le commit. Par défaut claude/install-hyperframes. Crée la branche si elle n'existe pas ; ne fait jamais de commit sur main.
  • dry_run : booléen, optionnel. Quand vrai, affiche les modifications prévues et se termine sans écrire.

Processus

Exécutez chaque étape dans l'ordre. Chaque étape est idempotente — réexécutée sur un dépôt déjà intégré, elle ne fait rien pour cette étape.

Étape 1 — Pré-vol

  1. Confirmer que repo_root contient CLAUDE.md avec la ligne ## How to Add a New Provider. Refuser de s'exécuter si absent — ce n'est pas un dépôt marketing-engine.
  2. Confirmer que lib/providers/video.ts, lib/providers/matrix.ts, lib/providers/types.ts et lib/providers/__mocks__/video.ts existent. Refuser de s'exécuter si l'un d'eux manque.
  3. Confirmer que la branche active n'est pas main. Si sur main, créer et basculer sur branch d'abord.

Étape 2 — Ajouter les trois skills d'exécution

Créer ces trois répertoires avec les fichiers SKILL.md. Chaque fichier existe déjà dans la version canonique de l'arbre — copier depuis la section Ensemble d'artefacts de référence ci-dessous textuellement. Ignorer un fichier s'il existe déjà et que son name de frontmatter correspond.

  • .skills/hyperframes/SKILL.md — règles de création de composition (mise en page avant animation, timelines mises en pause et enregistrées sur window.__timelines, pas de Math.random()/logique temporelle, variables déclarées via data-composition-variables).
  • .skills/hyperframes-cli/SKILL.md — boucle de développement npx hyperframes lint → inspect → render. Toujours rendu avec --strict --strict-variables.
  • .skills/hyperframes-prompt-builder/SKILL.md — spécialiste invoqué par video-prompt-builder lorsque la matrice résout en hyperframes ; charge les jetons de marque depuis clients/<slug>/design.md, choisit un modèle par task_kind, retourne une spécification de composition + arguments de rendu.

Étape 3 — Mettre à jour le skill de répartition

Dans .skills/video-prompt-builder/SKILL.md :

  1. Ajouter hyperframes-prompt-builder à la liste des spécialistes dans le paragraphe d'ouverture et la section Skills connexes.
  2. Étendre l'énumération d'entrée task_kind avec motion_typography, data_viz_reel, programmatic_short.
  3. Dans l'étape Processus qui vérifie les variables d'environnement, ajouter HYPERFRAMES_ACTIVE à la liste.
  4. Dans le mappage fournisseur→spécialiste, ajouter la ligne Hyperframes -> hyperframes-prompt-builder.
  5. Ajouter un exemple : une bobine KPI hebdomadaire routée vers HyperFrames avec task_kind: programmatic_short.

Ignorer toute sous-étape dont la chaîne cible est déjà présente.

Étape 4 — Étendre la couche fournisseur

Dans lib/providers/types.ts, ajouter trois membres à l'union VideoTask :

| "motion-typography"
| "data-viz-reel"
| "programmatic-short"

Dans lib/providers/matrix.ts :

  • Ajouter trois lignes à EMBEDDED_DEFAULTS.video : motion-typography, data-viz-reel, programmatic-short — chacune par défaut hyperframes.
  • Ajouter des alias d'étiquette à TASK_LABEL_MAP : "motion typography", "kinetic typography", "data viz reel", "data-viz reel", "programmatic short", "parametrized short".

Dans lib/providers/video.ts :

  • Ajouter une classe HyperframesVideoProvider étendant RealVideoBase, conditionnée par process.env.HYPERFRAMES_ACTIVE === "true", qui lève une erreur "local CLI render required in caller context; stub" depuis realGenerate (correspondant au pattern stub existant de higgsfield/topview).
  • Enregistrer hyperframes: () => new HyperframesVideoProvider() dans REAL_VIDEO_REGISTRY.

Dans lib/providers/__mocks__/video.ts :

  • Ajouter un MockHyperframesVideoProvider étendant BaseMockVideo avec name = "hyperframes".
  • Enregistrer hyperframes: () => new MockHyperframesVideoProvider() dans MOCK_VIDEO_REGISTRY.

Étape 5 — Mettre à jour le fichier de matrice de routage

Dans .specs/architecture/PROVIDERS.md, ajouter trois lignes à la table Routage vidéo :

| Motion typography | hyperframes | HTML/GSAP kinetic type, brand-faithful, deterministic |
| Data viz reel | hyperframes | declared variables → re-renderable charts (NYT-style) |
| Programmatic short | hyperframes | parametrized HTML composition; byte-identical re-renders |

Étape 6 — Mettre à jour .env.example

Ajouter, après WAVESPEED_API_KEY= :

# HyperFrames est un rendu HTML→MP4 local ; aucune clé API nécessaire.
# Définir HYPERFRAMES_ACTIVE=true une fois que `npx hyperframes doctor` passe localement
# (Node >= 22, FFmpeg dans PATH). Voir https://github.com/wesleysimplicio/hyperframes
HYPERFRAMES_ACTIVE=false

Étape 7 — Mettre à jour CLAUDE.md

  1. Dans le tableau Stack, changer la cellule des fournisseurs de la ligne Video pour inclure hyperframes (local HTML→MP4).
  2. Dans Skills disponibles, insérer trois lignes après wavespeed-batch :
    • hyperframes — création de composition animée avec HTML comme source de vérité.
    • hyperframes-cli — exécute npx hyperframes lint/inspect/preview/render.
    • hyperframes-prompt-builder — sélectionné par video-prompt-builder lorsque la matrice résout en hyperframes.

Étape 8 — Vérifier

  1. Analyser .specs/architecture/PROVIDERS.md via le test ci-dessous et affirmer que motion-typography, data-viz-reel, programmatic-short résolvent tous en hyperframes.
  2. Exécuter npm run typecheck — accepter toute défaillance préexistante non liée aux modifications (par exemple, @types/node manquant) ; échouer si une nouvelle erreur TypeScript référence la couche fournisseur.
  3. Exécuter npm run router:check si un .env existe dans le dépôt ; sinon ignorer (le script nécessite .env et n'est pas lié à la forme de l'intégration).
  4. Confirmer que git status montre uniquement les fichiers attendus.
node --input-type=module -e "
import { readFileSync } from 'node:fs';
const text = readFileSync('.specs/architecture/PROVIDERS.md', 'utf8');
const expected = ['motion-typography', 'data-viz-reel', 'programmatic-short'];
for (const key of expected) {
  if (!text.toLowerCase().includes(key.replace(/-/g, ' '))) {
    console.error('MANQUANT:', key); process.exit(1);
  }
}
console.log('PROVIDERS.md OK');
"

Étape 9 — Commiter et pousser

  1. Indexer exactement les fichiers que ce skill a touchés. Ne jamais utiliser git add -A.
  2. Commiter avec le message canonique :
    feat(skills): connecter HyperFrames en tant que fournisseur vidéo
    
    plus un corps décrivant l'exécution du contrat en trois étapes (voir le commit de référence fusionné pour le libellé).
  3. Pousser vers origin <branch>. Ouvrir une pull request en brouillon si aucune n'existe pour la branche.

Sorties

  • branch : chaîne. La branche qui contient le commit.
  • pr_url : chaîne. L'URL de la pull request en brouillon, si elle a été créée ou existait déjà.
  • files_written : tableau de chemins relatifs réellement créés ou modifiés.
  • files_skipped_idempotent : tableau de chemins relatifs qui étaient déjà corrects.
  • verification : { providers_md_pass: booléen, typecheck_pass: booléen, router_check: "pass" | "skipped" | "fail" }.

Règles non négociables

  • Idempotent. Réexécuté sur un dépôt déjà intégré, ne touche aucun fichier.
  • Ne jamais commiter sur main. Créer d'abord une branche de fonctionnalité ; la politique de branche du moteur est appliquée en amont.
  • Aucun corps de skill ne mentionne hyperframes en dehors du contrat. La sélection du fournisseur passe toujours par PROVIDERS.md + lib/router.ts. Ce skill est l'amorçage ; la sélection à l'exécution reste agnostique au fournisseur.
  • Ne pas modifier un MP4 rendu ni aucun fichier sous outputs/. Ce skill modifie uniquement la plomberie du moteur.
  • Ne jamais supprimer un skill compliance-<client actif> existant ni aucun artefact spécifique au client. L'intégration est additive.

Modes d'échec

  • Échec de l'étape 1 de pré-vol (pas un dépôt marketing-engine) : afficher le fichier manquant et s'arrêter. Ne pas essayer de le "réparer".
  • Un fichier existe déjà avec un contenu conflictuel (par exemple, .skills/hyperframes/SKILL.md a été modifié manuellement) : faire un diff par rapport au contenu canonique ; afficher le diff ; demander à l'opérateur avant d'écraser.
  • npm run typecheck signale une nouvelle erreur TypeScript dans lib/providers/ : s'arrêter, afficher l'erreur, ne pas commiter.
  • git push échoue pour des raisons non réseau : s'arrêter. Les échecs réseau sont réessayés selon la politique git du projet (2s, 4s, 8s, 16s de backoff, jusqu'à 4 tentatives).

Skills connexes

  • hyperframes : création à l'exécution (installé par ce skill à l'étape 2).
  • hyperframes-cli : lint/inspect/render à l'exécution (installé par ce skill à l'étape 2).
  • hyperframes-prompt-builder : spécialiste à l'exécution (installé par ce skill à l'étape 2).
  • video-prompt-builder : répartiteur mis à jour par ce skill à l'étape 3.
  • llm-router : non lié ; le routage des fournisseurs LLM est un répartiteur parallèle.

Ensemble d'artefacts de référence

Les contenus canoniques de chaque fichier que ce skill écrit se trouvent dans le commit fusionné sur main :

  • Skills : .skills/hyperframes/SKILL.md, .skills/hyperframes-cli/SKILL.md, .skills/hyperframes-prompt-builder/SKILL.md
  • Couche fournisseur : lib/providers/types.ts, lib/providers/matrix.ts, lib/providers/video.ts, lib/providers/__mocks__/video.ts
  • Matrice de routage : .specs/architecture/PROVIDERS.md
  • Env : .env.example
  • Charte : CLAUDE.md

En cas de doute, effectuer un diff par rapport à origin/main au commit de référence fusionné et copier la version canonique textuellement. Ne pas retaper de mémoire.

Référence amont

Individual skills in this repo

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

Skills associés