tiptap-generator

tiptap-generator

Catalogue généré le 2026-05-11

En une phrase

Génère et valide automatiquement le JSON TipTap pour les articles du site éducatif d'espagnol juanmaycompania, en respectant la spec exacte de l'éditeur et en intégrant images, audio et PDF.

Quand l'utiliser

• Quand tu veux créer un nouvel article ou une nouvelle leçon sur juanmaycompania
• Pour transformer un texte brut en contenu structuré avec encarts, onglets, flip cards, timeline
• Quand tu as des images, audios ou PDFs à intégrer dans une leçon
• Pour mettre à jour le contenu d'un article existant en gardant le format JSON propre
• Avant un import en base pour t'assurer que le JSON sera accepté par l'éditeur

Comment l'invoquer

• Slash command : /tiptap-generator
• Phrases déclencheurs (texte) : "génère un article TipTap", "crée du contenu pour juanmaycompania", "JSON pour l'éditeur"
• Auto-invocation : ✅ Oui — quand on demande de générer un article, du contenu TipTap, ou du JSON pour l'éditeur

Description détaillée

TipTap est l'éditeur de contenu utilisé par juanmaycompania, et son format de stockage est un JSON arborescent assez strict. Une virgule mal placée et l'article entier ne s'affiche plus. Ce skill évite ce risque en suivant un workflow obligatoire.

Première étape : il lit la spec complète (~/.claude/skills/tiptap-generator/spec/tiptap-mcp-spec.md) qui décrit tous les nœuds autorisés (heading, paragraph, tabs, flipCard, timeline, customImage, audio, pdf, etc.) et leurs attributs. Deuxième étape : il génère le JSON conformément à cette spec. Troisième étape, cruciale : il valide le résultat en l'envoyant à validate.js, qui détecte les erreurs de schéma. S'il y a des erreurs, il corrige et re-valide en boucle jusqu'à ce que ça passe.

Il connaît les règles absolues : racine toujours { "type": "doc", "content": [...] }, pas de HTML inline dans les textes (on utilise les marks), heading.level limité à 2/3/4, et les attributs JSON stringifiés des composants composites (tabs.tabs, flipCard.cards, timeline.items) qui sont des strings JSON échappées. Il intègre automatiquement les médias quand il voit les tags [IMAGE DISPONIBLE — url: X], [AUDIO DISPONIBLE — url: X] ou [PDF DISPONIBLE — url: X]. Pour Thymon : c'est ton générateur de contenu attitré pour le site espagnol, qui te permet de partir d'un texte brut et d'avoir un JSON valide sans toucher au code.

Source

• Plugin : perso (standalone)
• Nom interne : tiptap-generator
• Fichier : /home/thymon/.claude/skills/tiptap-generator/SKILL.md