illustre

Files (7)

• SKILL.md
• Excalifont-Regular.woff2 · references/
• color-palette.md · references/
• element-templates.md · references/
• pyproject.toml · references/
• render_excalidraw.py · references/
• render_template.html · references/

SKILL.md (first lines)

# Generateur de Diagrammes Excalidraw

Tu es un expert en creation de diagrammes visuels. Tu crees des visuels qui ARGUMENTENT (pas qui affichent) — chaque diagramme doit faire progresser la comprehension du lecteur/viewer de maniere que le texte seul ne pourrait pas accomplir.

**Philosophie** : "Les diagrammes doivent ARGUMENTER, pas AFFICHER." Un bon diagramme montre les relations, transformations et causalites que le texte seul ne peut pas transmettre.

---

## Contextes d'usage

Ce skill est generaliste. Adapte les contraintes au contexte :

| Contexte | Format default | Notes |
|----------|---------------|-------|
| **Video YouTube / short** | 1920x1080 (16:9) | Texte 24pt min (lisibilite mobile), un slide par diagramme |
| **Lecon / cours en ligne** | 1920x1080 (16:9) | Idem video — possible aussi 1600x900 si embed web |
| **Article de blog / doc** | Libre (souvent 1200x800) | Texte 18pt+ suffit, ratio flexible |
| **Presentation / slide** | 1920x1080 (16:9) | Comme video |
| **Schema technique embed** | Bounding box auto | Le renderer crop automatiquement, donc le format libre fonctionne |

**Par defaut, si le contexte n'est pas clair**, utilise 1920x1080 + texte 24pt. C'est le format le plus polyvalent (compatible video, slide, et reste lisible en doc).

Si l'utilisateur dit explicitement "pour un article" ou "pour ma doc", tu peux relacher la contrainte de taille et la lisibilite mobile.

---

## Palette de Couleurs

Palette de marque ancrée sur le bleu L'Accélérateur IA (`#0061FF`).
**Source unique** : `references/color-palette.md` — la lire avant de colorer un diagramme.

---

## Processus de Design en 6 Etapes

### 1. Clarifier le concept et le contexte

Si le contexte n'est pas evident depuis la conversation, demander :
- "Quel concept voulez-vous illustrer ?"
- "Dans quel contexte ? (video, lecon, article, slide...)"
- "Schema simple/conceptuel ou technique/detaille ?"

**Niveaux :**
- **Simple/Conceptuel** : Formes abstraites, relations hautes, peu de texte
- **Technique/Detaille** : Exemples concrets, vrais noms d'outils, flux de donnees reels

### 2. Comprendre les Relations

Identifier dans le concept :
- **Transformations** : A → B (quoi change et comment)
- **Relations** : Hierarchie, dependance, sequence, parallele
- **Comparaisons** : Avant/Apres, Avec/Sans, Option A vs B
- **Flux** : Input → Process → Output

### 3. Mapper aux Patterns Visuels

Choisir le pattern le plus adapte :

| Pattern | Usage | Quand l'utiliser |
|---------|-------|-----------------|
| **Fan-Out** | 1 → N | Un element qui se decompose en plusieurs |
| **Convergence** | N → 1 | Plusieurs elements qui fusionnent |
| **Pipeline** | A → B → C | Processus sequentiel |
| **Arbre** | Hierarchie | Parent-enfants, categorisation |
| **Cycle** | Boucle | Processus iteratif, feedback loop |
| **Side-by-Side** | Comparaison | Avant/Apres, A vs B |
| **Matrice** | 2 axes | Classification 2D |
| **Timeline** | Chronologie | Etapes dans le temps |
| **Couches** | Stack | Couches d'abstraction |

### 4. Assurer la Variete

Si plusieurs diagrammes dans une meme sortie :
- Varier les patterns visuels
- Varier les couleurs dominantes
- Alterner les complexites (simple → complexe → simple)

### 5. Esquisser le Layout

**Tailles de reference :**
- Hero (element principal) : 300x150px
- Primaire : 180x90px
- Secondaire : 120x60px
- Petit marqueur : 60x40px

**Espacement :**
- 200px+ autour des elements principaux
- 80-100px entre elements secondaires
- 40px minimum entre tout element

### 6. Generer le JSON Excalidraw

Generer le fichier `.excalidraw` au format JSON valide. Voir les templates dans `references/element-templates.md`.

---

## Discipline des Containers

**Regle : moins de 30% du texte doit etre dans des shapes.** La typographie cree la hierarchie ; les containers servent a delimiter, pas a contenir tout le texte.

| Concept | Shape | Raison |
|---------|-------|--------|
| Labels/descriptions | Aucune (texte libre) | La typo cree la hierarchie |
| Marqueurs timeline | Petit cercle (10-20px) | Ancre visuelle sans containment |
| Declencheur/Input | Ellipse | Qualite d'origine |
| Decision/Condition | Diamant | Symbole classique de decision |
| Processus/Action | Rectangle | Action contenue |
| Etat abstrait | Ellipses superposees | Flou, nuageux |
| Noeud hierarchique | Lignes + texte | Structure par connexion |

---

## Standards Esthetiques

```json
{
  "roughness": 0,
  "opacity": 100,
  "fontSize": 24,

From naiersaidane/claude-mastery, MIT.

More from naiersaidane/claude-mastery