🚀 Les "Skills" de Matt Pocock : Le Repo GitHub qui Révolutionne le Dev Agentique

📋 Overview

• Type : Tutorial / Review (Test pratique d'un outil)
• Sujet principal : Présentation et test en conditions réelles du repo de "skills" de Matt Pocock pour le développement assisté par IA (agentique).
• Intervenant : Un créateur de contenu YouTube (dev à temps plein sur le sujet agentique), avec des extraits audio de Matt Pocock lui-même.

🎯 Core Purpose & Context

• Pourquoi cette vidéo ? Le créateur, initialement sceptique face à la hype, décide de tester en profondeur le repo de Matt Pocock pour vérifier s'il tient ses promesses.
• Contexte de la hype : Matt Pocock, ancien coach vocal devenu star du dev, a créé le 3 février 2026 un repo GitHub recensant tous ses "skills" de codage. En 6 mois, il a atteint 200 000 stars, entrant dans le top 30 des repos les plus populaires de tous les temps sur GitHub.
• Comparaison marquante : Python (11e) a mis 12 ans pour atteindre une popularité comparable. Le repo est plus populaire que Kit (Microsoft) ou BMAD.
• Le cas d'usage concret : Ajouter une nouvelle feature à son application Android "Send to Kindle" — la fusion de plusieurs articles (via URL) en un seul document envoyé à sa liseuse.

---

🧠 Key Concepts & Steps (Le Workflow Détaillé)

🔧 Installation & Setup

1. Installation : Une seule commande à la racine du projet.
2. Setup (setup Matt Pocock skills) : Pose 2 questions clés :
   • Où stocker les futurs tickets ? (GitHub Issues, Linear, Jira, ou local en Markdown)
   • Quels labels/tags utiliser ?
3. Génération de 3 fichiers de config :
   • issue-tracker.md : indique à l'agent où écrire les tâches (ici GitHub Issues).
   • label.md : définit les tags (enhancement, bug, ready for agent...).
   • domain.md : indique à l'agent comment naviguer dans le projet et où se trouvent les fichiers importants.

🦴 La Colonne Vertébrale (5 skills principaux)

L'ordre du flow principal : Grill me with Docs → spec → ticket → implement → code review

Figure 1 — La colonne vertébrale du workflow : cinq skills enchaînés du grilling jusqu'à la code review automatique.

Étape par étape :

Skill	Fonction
Ask Matt	Un skill "guide" qui répond à vos questions sur quoi faire ensuite (ex : "quelle est la prochaine étape après le setup ?").
Grill me with Docs	Un interrogatoire intensif basé sur un arbre de décision. Pose des dizaines de questions (l'auteur y a répondu à ~30) pour combler le "gap" entre votre pensée et la compréhension de l'agent. Questions posées par lots avec choix multiples + réponse recommandée. Documente les décisions dans un dossier ADR (Architecture Decision Records) et crée un context.md (vocabulaire partagé).
Grill me (sans Docs)	Identique, mais ne modifie pas la codebase. Idéal pour du brainstorming général.
spec	Génère une spécification (fonctionnelle ET technique) sous forme d'issue GitHub.
ticket	Découpe la spec en tickets concrets, chacun apportant de la valeur à l'utilisateur. Gère les dépendances (ex : "envoyer document" bloqué par "ajouter URL").
implement	Utilise un ou plusieurs sous-agents + le skill TDD si nécessaire. Lance ensuite automatiquement la code review.
code review	Vérifie 2 choses : la valeur utilisateur est présente + le respect des bonnes pratiques.

🎁 Skills secondaires (hors flow principal)

• improve codebase architecture : propose des axes de refacto → grilling → spec → tickets → implement.
• Diagnostic de bug : reproduit le bug, propose des hypothèses, corrige et ajoute des tests de non-régression.
• End off : écrit un résumé de la discussion en cours pour la passer à un autre agent (utile quand une conversation ouvre de nouveaux sujets).
• Wayfinder : pour les idées floues et complexes → crée une roadmap sous forme d'issues GitHub interconnectées, traitées une par une.

Figure 2 — Deux philosophies opposées de la spec : document vivant chez SpecKit, artefact jetable chez Matt Pocock.

⚖️ Distinction Clé : La "Spec" selon Matt Pocock vs SpecKit

• SpecKit : une spec est un document purement fonctionnel (point de vue utilisateur, sans technique).
• Matt Pocock : une spec est fonctionnelle ET technique, mais jetable. Citation :

"For me, I close the issue containing the spec and the spec is gone... Once the spec is present in the code, then you can just delete the spec. Whereas people who do spec-driven development go back to the spec and edit it."

• Philosophie centrale : le code est la seule source de vérité.

Figure 3 — Le vrai goulot d'étranglement du dev agentique : la clarté de la communication humain-agent, pas la vitesse de génération de code.

---

🧭 Strategic Analysis & "Game Changers"

• Le vrai game changer : Le repo ne vise pas à coder à votre place, mais à mieux vous faire utiliser l'agent. L'auteur le souligne : "je préfère les skills qui nous aident à mieux utiliser un agent plutôt que ceux qui nous aident à coder." C'est un renversement de perspective : le goulot d'étranglement du dev agentique n'est pas la génération de code, mais la clarté de la communication humain-agent.

• Le concept sous-jacent (Hidden Connection) : Le "grilling" (interrogatoire) est en réalité une méthode pour forcer la clarté cognitive du développeur. On ne peut pas déléguer efficacement une tâche mal définie. Le succès du repo révèle que le problème n°1 des devs avec l'IA n'est pas technique mais un problème de spécification/communication.

• Le "So What?" : Le succès fulgurant (top 30 en 6 mois) signale un basculement de l'écosystème. On passe du "prompt à la volée" à une méthodologie structurée (grilling → spec → tickets → implement). Ceux qui maîtrisent ce workflow prennent une avance compétitive.

• Le vocabulaire partagé (context.md) : L'idée que vous et l'agent doivent "parler exactement le même langage" est un puissant levier de fiabilité, souvent ignoré.

---

📊 Detailed Breakdown (Chronologique)

• [00:00:00] Présentation de Matt Pocock (ancien coach vocal) et de son repo créé le 03/02/2026, passé à 200 000 stars, top 30 GitHub de tous les temps.
• [00:00:39] Comparaison avec Python (12 ans pour une popularité équivalente). Étonnement : plus populaire que Kit (Microsoft) et BMAD.
• [00:01:04] Scepticisme initial de l'auteur : simple hype exploitant l'audience de Matt ? Mais la hype persiste depuis 6 mois (vidéos à +100k vues). Décision d'enquêter.
• [00:02:40] Présentation du projet perso : "Send to Kindle" (app Android). Aide à moins se distraire (vs shorts YouTube). 2 features existantes : envoi via URL et envoi de fichier local.
• [00:03:36] Objectif : nouvelle feature = fusionner plusieurs URLs d'articles en un seul document ("livre d'articles").
• [Setup] Installation + setup, génération des 3 fichiers de config (issue-tracker.md, label.md, domain.md).
• [00:06:05] Confusion face aux 25 skills disponibles, noms cryptiques ("Grill Me"), README peu clair. Découverte de Ask Matt qui recommande de lancer Grill with Docs.
• [Grilling] Session d'interrogatoire : ~30 questions, arbre de décision, l'auteur "poussé dans ses retranchements". Génération du dossier ADR et du context.md.
• [00:09:59] Explication du context.md (vocabulaire partagé) et distinction Grill me / Grill me with Docs.
• [00:11:58] Retour au code. spec génère une énorme issue GitHub (fonctionnel + technique). Extrait audio de Matt sur la spec jetable.
• [Tickets] ticket découpe en tâches concrètes avec dépendances (ex : design du menu, ajout/suppression d'URL, envoi groupé).
• [Implement] Nouvelle session, implement avec sous-agents + TDD (cycle : test qui échoue → code → refacto). Puis code review automatique.
• [00:14:12 - Test] Vérification : nouvel item dans le menu ✅, page de fusion ✅ (mais design décevant, maquettes mal appliquées), détection auto du copier-coller d'URL ✅, ajout/suppression ✅, envoi réussi ✅, article visible sur Kindle avec sommaire fonctionnel ✅.
• [Skills bonus] Présentation de improve codebase architecture, diagnostic de bug, End off, Wayfinder.
• [00:17:56] Conclusion et appel à l'abonnement.

Figure 4 — Les cinq enseignements essentiels du repo de Matt Pocock pour structurer un workflow de développement agentique.

---

🔑 Key Takeaways

1. Le repo mise sur la communication, pas le code brut : clarté, vocabulaire partagé, compréhension profonde du projet.
2. Le "grilling" (interrogatoire par arbre de décision) est le skill le plus transformateur pour aligner l'agent sur votre intention réelle.
3. Workflow structuré : Grill → Spec → Tickets → Implement → Code Review, avec livraison de valeur à chaque étape.
4. La spec est jetable chez Matt Pocock : le code reste la seule source de vérité.
5. Skills préférés de l'auteur : Grill Me, Grill Me with Docs, End off, Wayfinder.

⚠️ Limites & Points de Vigilance

• Repo jeune → nombreux bugs remontés dans les issues GitHub.
• implement n'applique pas toujours le TDD même quand nécessaire.
• La code review est faite mais parfois sans fix derrière.
• Verbosité excessive de certaines specs → contre-productif (trop de tâches noie l'agent).
• Écart de design constaté : les maquettes fournies n'ont pas été fidèlement appliquées.

❓ Unresolved Questions / Follow-up

• Comment améliorer la fidélité de l'agent aux maquettes de design (problème rencontré) ?
• Le repo va-t-il mûrir et corriger les bugs de implement (TDD) et de la code review ?
• Comment gérer/limiter la verbosité des specs pour rester productif ?
• Le workflow reste-t-il efficace sur des projets bien plus complexes que ce side-project ?

(Note : la vidéo mentionne le lancement prochain d'une newsletter dédiée aux meilleures pratiques du dev agentique.)