---
name: how-to-create-a-skill
description: >
  Apprend à créer une skill Make personnalisée. Déclenche ce skill quand
  l'utilisateur veut créer sa propre skill, comprendre comment les skills
  fonctionnent, ou packager un workflow répétable en commande slash.
  Utilise ce skill avec /how-to-create-a-skill.
---

# 🛠️ Comment créer une skill Make

Une skill, c'est un simple fichier Markdown qui enseigne à Make
comment effectuer une tâche répétable. Une fois créée, tu l'appelles
avec `/nom-de-ta-skill` dans le chat.

---

## Structure minimale

```markdown
---
name: nom-de-ta-skill
description: >
  Décris ICI quand Make doit utiliser cette skill — sois précis.
  Make lit cette description pour décider si la skill est pertinente.
  Ex : "Utilise ce skill quand l'utilisateur demande à créer un composant
  Button avec des variantes Primary, Secondary et Ghost."
---

# Titre de ta skill

Contexte : explique brièvement ce que fait cette skill et dans quel projet.

## Quand l'utiliser

- Cas 1 où déclencher la skill
- Cas 2 où déclencher la skill

## Étapes

1. Première chose à faire
2. Deuxième chose
3. Troisième chose

## Règles importantes

- Règle 1 que Make doit toujours respecter
- Règle 2
```

---

## Les 3 parties essentielles

### 1. Le frontmatter YAML (entre les ---)
C'est la carte d'identité de ta skill.
- `name` → le nom de la commande slash (sans espaces, avec tirets)
- `description` → **la partie la plus importante** — Make la lit pour
  décider si la skill s'applique. Sois précis sur les déclencheurs.

### 2. Le titre et le contexte
Un `#` heading suivi d'une phrase qui explique le projet et l'objectif.
Make s'en sert pour cadrer toutes les décisions qui suivent.

### 3. Les instructions
Markdown classique : listes, tableaux, blocs de code.
Make suit les étapes dans l'ordre — sois séquentiel et concret.

---

## Bonnes pratiques

**Description** — écris-la comme si tu expliquais à quelqu'un QUAND
utiliser cette skill, pas CE QU'ELLE FAIT.

```
✅ "Utilise ce skill quand l'utilisateur veut créer un composant
   avec des variantes ou modifier les tokens de couleur du projet."

❌ "Ce skill gère les composants et les tokens."
```

**Instructions** — préfère les listes et tableaux aux paragraphes.
Make parse mieux les formats structurés.

**Longueur** — une skill efficace tient en 1-2 pages.
Si c'est plus long, tu essaies de tout mettre dedans — découpe en
plusieurs skills spécialisées plutôt qu'une skill fourre-tout.

**Tester** — après import, tape `/nom-de-ta-skill` dans Make et
ajoute une demande simple. Si Make hésite ou rate, c'est souvent
la `description` qui n'est pas assez précise.

---

## Exemple concret — skill "design-crit"

```markdown
---
name: design-crit
description: >
  Effectue une critique design sur les écrans du projet en cours.
  Déclenche ce skill quand l'utilisateur demande un avis, une review,
  une critique, ou veut améliorer ses écrans. Analyse la hiérarchie
  visuelle, la cohérence des couleurs, l'accessibilité et l'UX mobile.
---

# Design Critique — Killer APP

Analyse les écrans fournis et donne un feedback structuré.

## Grille d'analyse

1. Hiérarchie visuelle — le regard sait où aller ?
2. Cohérence — les couleurs/fonts sont-elles issues du design system ?
3. Accessibilité — contraste suffisant ? Touch targets ≥ 44px ?
4. UX mobile — safe areas respectées ? Thumb zone OK ?
5. Copy — texte clair ? Correct en français ?

## Format de réponse

Pour chaque écran :
- ✅ Ce qui fonctionne bien
- ⚠️ Ce qui peut être amélioré
- 🔧 Suggestion concrète d'amélioration
```

---

## Importer dans Make

1. Sauvegarder le fichier en `.md`
2. Dans Make → boîte de prompt → **Skills** → **Create skill**
3. Glisser le fichier ou **Import from computer**
4. Vérifier le nom et la description → **Create**
5. Appeler avec `/nom-de-ta-skill` dans le chat

---

## Limite Make à connaître

Make accepte uniquement un **fichier `.md` unique**.
Pas de dossiers, pas de `references/`, pas de scripts.
Tout doit tenir dans un seul fichier Markdown.