Newsletter : skill complet

Exemple réel : mon skill /newsletter (semi-automatique) avec méthode embarquée, scoping interactif, recherche multi-sources et deep dive long-form.

Mon skill réel : /newsletter

Voici mon skill Newsletter tel qu'il existe dans mon coffre, dans DigitalGarden/4 TOOLS/skills/newsletter/SKILL.md. C'est un skill semi-automatique : scoping interactif au début (5 min de dialogue), puis recherche et rédaction automatiques.

Les clés API ont été retirées, mais la structure et la méthode sont exactement celles que j'utilise chaque semaine.

Interactif
1. Scoping du sujet
Dialogue, 5 min
Auto
2. Recherche perso
YouTube + daily notes
Auto
3. Recherche web
Firecrawl + vault
Auto + validation
4. Rédaction complète
News perso (~300 mots) + Deep dive (~2000 mots)
Vérification
5. Checklist qualité
Prête à copier-coller

Métadonnées du process

ChampValeur
FréquenceWeekly
DéclencheurMardi (envoi mercredi matin)
Temps avant3-4h
Temps avec skill1-2h
Type de skillSemi-automatique

Le fichier SKILL.md

DigitalGarden/4 TOOLS/skills/newsletter/SKILL.md :

---
name: newsletter
description: Rédige la newsletter hebdomadaire Perspectives IA. News perso + deep dive long-form style Tomas Pueyo, avec scoping interactif du sujet et recherche multi-sources (vault + Firecrawl). Usage hebdomadaire le mardi.
---

# Newsletter Perspectives IA

Génère la newsletter hebdomadaire : news perso + deep dive long-form.

## Input

- `$ARGUMENTS` : Sujet ou angle pour le deep dive (optionnel, si absent on scope ensemble)
- Daily notes de la semaine en cours (phase de vie active)
- Dernières vidéos YouTube
- Recherche web sur le sujet du deep dive

## Output

- Newsletter complète en markdown, 1500-3000 mots total
- Objet (max 50 caractères) + preview text (max 90 caractères)
- 2 sections : news perso (~300 mots) + deep dive (~1500-2500 mots)
- Prête à copier-coller dans l'outil d'envoi

## Processus

### Étape 1 : Scoping du sujet (dialogue interactif)

**Méthode :** sans scoping, l'IA écrit un article générique. 5 minutes de dialogue suffisent pour avoir mon angle, mes convictions, mes idées brutes. Pas de recherche à ce stade, juste mes idées.
**Outils :** dialogue uniquement.
**Piège :** poser toutes les questions d'un coup. Une question à la fois, attendre la réponse.

Si `$ARGUMENTS` est vide ou vague, pose ces questions une par une :
- "Quel sujet te tient à coeur cette semaine ?"
- "Quel angle spécifique ? Pas juste 'l'IA' mais genre 'pourquoi l'IA va rendre les managers obsolètes'"
- "C'est quoi ton contrarian take ? Qu'est-ce que la plupart des gens ont faux ?"
- "Quelles sont tes idées brutes, tes intuitions ?"
- "Quelle transformation tu veux créer chez le lecteur ?"

Si `$ARGUMENTS` est déjà précis, résume ta compréhension et demande validation.

**→ Attend la validation du sujet avant de continuer.**

### Étape 2 : Recherche perso (news sur moi)

**Méthode :** la section news perso fait ~300 mots. Pas un journal intime : un partage stratégique qui crée de la connexion et fait découvrir mes contenus. Promo naturelle intégrée dans le récit, jamais en encart pub.
**Outils :** Firecrawl pour fetch les dernières vidéos YouTube, Glob/Read pour les daily notes.
**Piège :** inventer des anecdotes. N'utilise que ce qui est réellement dans les daily notes et le fetch YouTube.

- a) Fetch les 2-3 dernières vidéos YouTube via Firecrawl scrape sur la page `/videos` de la chaîne.
- b) Lis les daily notes des 7 derniers jours dans la phase de vie active : anecdotes concrètes, avancement des projets, moments marquants.

### Étape 3 : Recherche deep dive

**Méthode :** vault d'abord (ce que j'ai déjà), web ensuite (données fraîches). Les sources enrichissent mes idées, elles ne les remplacent pas. Mon point de vue reste le fil conducteur.
**Outils :** Glob/Grep sur le vault, Firecrawl search pour le web.
**Piège :** copier le style des sources. Reformule toujours avec ma voix.

- a) Cherche dans le vault (`3 GARDEN/Notes/`, `2 CAPS/`) ce que j'ai déjà sur le sujet.
- b) Lance 3-5 recherches Firecrawl avec des angles différents : sujet + données récentes, arguments contraires, études académiques, exemples concrets.
- c) Deep scrape les 2-3 articles les plus pertinents pour extraire données, arguments, citations.

### Étape 4 : Rédiger la newsletter

**Méthode :** thèse claire dès le début. Construction progressive de l'argument. Données et recherche pour crédibiliser. Perspectives contraires adressées honnêtement. Sous-titres qui racontent déjà l'histoire. Conclusion avec takeaway actionnable.
**Outils :** Write.
**Piège :** liste de tips. UN seul argument construit.

Assemble la newsletter avec cette structure :

**Objet :** phrase intrigante (max 50 caractères)
**Preview :** suite de l'accroche (max 90 caractères)

Salut,

[Section 1, News sur moi, ~300 mots]
Ce qui s'est passé cette semaine. Dernière vidéo YouTube (titre + lien + pourquoi). Avancement projets. Anecdote concrète qui fait la transition vers le deep dive. Promo naturelle dans le récit.

**[Titre du deep dive, affirmatif, provocateur]**

[Section 2, Deep dive, 1500-2500 mots]
Thèse claire. Construction progressive. Données et perspectives contraires. Exemples concrets. Sous-titres clairs. Conclusion actionnable.

À mercredi prochain,
Eliott

**→ Affiche la newsletter complète et demande validation.**

### Étape 5 : Vérification finale

Checklist :
- [ ] Section perso : ~300 mots, dernière vidéo YouTube mentionnée, anecdote concrète
- [ ] Deep dive : 1500-2500 mots, UN argument principal, au moins 3 données/références
- [ ] Tutoiement partout, jamais de vouvoiement
- [ ] Aucun mot faible ("peut-être", "il semble que")
- [ ] Ton direct et affirmatif
- [ ] Sous-titres qui racontent l'histoire
- [ ] Pas de liste de tips. Un argument construit.
- [ ] Takeaway actionnable à la fin
- [ ] Objet < 50 caractères, intriguant
- [ ] Preview < 90 caractères
- [ ] Max 2 emojis dans tout le texte
- [ ] Total : 1500-3000 mots

## Méthode détaillée

### La structure (2 sections)

**Section 1 : News sur moi** (~300 mots)

Une section courte et personnelle. Ce qui s'est passé cette semaine dans ma vie, mes projets, mes réflexions. Pas un journal intime : un partage stratégique qui crée de la connexion et fait découvrir mes contenus.

Contenu type :
- Dernière vidéo YouTube publiée (titre + lien + 1-2 phrases sur le pourquoi)
- Avancement d'un projet en cours
- Anecdote concrète de la semaine qui résonne avec le sujet du deep dive
- Promotion naturelle : les contenus arrivent dans le flux de la narration, pas en encart pub

**Section 2 : Deep dive** (~1500-2500 mots)

Un article de fond sur UN sujet. Pas un tips list. Pas un résumé d'actus. Un vrai article qui construit un argument, apporte de la recherche, et propose une perspective originale.

Inspiré par Tomas Pueyo (Uncharted Territories) et Forking Paths : thèse claire dès le début, données et recherche pour appuyer l'argument, perspectives contraires examinées honnêtement, exemples concrets et analogies, construction progressive de l'argument, conclusion avec takeaway actionnable.

### Règles de style (non négociables)

**Ce que je fais TOUJOURS :**
- Phrases courtes (max 20 mots la plupart du temps)
- Ton direct et affirmatif, je prends position
- Tutoiement systématique
- Au moins 3 références/données concrètes par article
- Des sous-titres clairs qui racontent déjà l'histoire
- Des analogies et métaphores pour rendre les concepts tangibles

**Ce que je ne fais JAMAIS :**
- "Il semble que", "on pourrait dire que", "peut-être"
- Listes de tips génériques (5 astuces pour...)
- Résumé neutre sans point de vue
- Intros de 3 paragraphes avant d'arriver au sujet
- Plus de 2 emojis dans tout le texte
- Jargon sans explication

### Qualité = Résonance x Nouveauté

La newsletter est réussie si :
- **UN argument principal** résumable en 1 phrase
- **Résonance** : le lecteur se dit "c'est exactement ce que je ressentais sans pouvoir le formuler"
- **Nouveauté** : au moins 1 insight que le lecteur n'a jamais vu présenté comme ça
- **Recherche visible** : données, études, exemples qui crédibilisent
- **Action claire** : le lecteur sait quoi faire ou penser différemment après

## Exemples

### Bon exemple : "Pourquoi 90% des formations en ligne échouent"

Thèse claire dès le titre. Article structuré autour d'un argument central (le modèle de la formation passive est mort). 3 études citées. Conclusion avec un framework actionnable. 2100 mots.

> Pourquoi c'est bon : un seul argument fort, bien documenté, avec une perspective originale. Le lecteur ressort avec une nouvelle façon de voir le sujet et une action claire.

### Mauvais exemple : "5 outils IA à tester cette semaine"

Liste de tips sans profondeur. Pas de thèse. Pas de recherche. Pourrait être écrit par n'importe qui. 800 mots.

> Pourquoi c'est raté : pas de point de vue, pas de structure argumentative, format "listicle" générique. Le lecteur referme et oublie dans la minute.

## Ce que tu ne fais PAS

- Inventer des anecdotes, utilise uniquement ce qui est dans les daily notes et le fetch YouTube
- Écrire un résumé d'actus, c'est un deep dive avec une thèse
- Lister plusieurs sujets, UN seul deep dive
- Écrire sans avoir scopé le sujet, le dialogue de l'étape 1 est obligatoire
- Résumer sans opinion, chaque affirmation a un point de vue
- Utiliser des formules creuses
- Copier le style des sources, reformule avec ta voix

Ce qu'il faut retenir

1. Tout est dans un seul fichier. Méthode, exemples, règles, processus. Pas de fiche process séparée à maintenir. Le SKILL.md est la source de vérité unique.

2. Le scoping interactif est l'étape la plus importante. Sans dialogue de 5 minutes au démarrage, l'IA écrit un article générique. C'est l'étape 1, et elle est obligatoire.

3. La méthode est étalée sur les étapes du processus. Chaque étape a sa propre section Méthode + Outils + Piège. C'est ça qui transforme le skill d'une suite d'instructions en un guide opérationnel.

4. La recherche est multi-sources. Vault d'abord (ce que tu as déjà), web ensuite (données fraîches). Les sources enrichissent tes idées, elles ne les remplacent pas.

5. La section "Ce que tu ne fais PAS" empêche la dérive. Souvent plus important que les instructions positives. L'IA a tendance à généraliser, c'est là qu'on la cadre.

6. Le skill a évolué en 5-6 itérations. Le scoping interactif a été ajouté après 2-3 newsletters décevantes. La checklist après des oublis de critères. Chaque mauvais output devient une nouvelle règle.