Donner un accès shell et un éditeur de code à un LLM sans méthodologie d’ingénierie revient à embaucher un développeur ultra-rapide mais amnésique, qui patche les symptômes sans chercher la cause racine.
Le dépôt open-source addyosmani/agent-skills formalise 24 compétences couvrant l’intégralité du cycle de vie logiciel (SDLC). Plutôt que de tout charger en permanence en mémoire, ces skills sont montés dynamiquement dans .agents/skills/ selon la phase exacte de la tâche.
Caractéristiques
| Phase SDLC | Skill Addy Osmani (.agents/skills/) | Rôle opérationnel |
|---|---|---|
| 1. Cadrage & Planification | planning-and-task-breakdown | Découpage en tâches atomiques ordonnées avec critères d’acceptation |
| 2. Diagnostic & Debug | debugging-and-error-recovery | Recherche scientifique de la cause racine (Root Cause) avant tout patch |
| 3. Qualité & Revue | code-review-and-quality | Grille d’audit multi-axes (logique, concurrence, fuites, maintenabilité) |
| 4. Sécurité & Durcissement | security-and-hardening | Contrôle OWASP Top 10, validation des entrées et gestion des secrets |
| 5. Mémoire & Architecture | documentation-and-adrs | Traçabilité des décisions d’architecture (Architecture Decision Records) |
1. Les 5 briques SDLC que j’utilise au quotidien
Parmi les 24 compétences de la collection, cinq constituent l’épine dorsale du pipeline d’ingénierie :
debugging-and-error-recovery(Diagnostic de cause racine) : interdit à l’agent de deviner ou d’empiler des rustines. Il impose le cycle scientifique : Observer l’erreur exacte -> Formuler une hypothèse -> Vérifier empiriquement -> Corriger la cause racine une seule fois.planning-and-task-breakdown: découpe les demandes complexes en unités atomiques vérifiables, directement interfacées avec un journal de suivi horodaté.code-review-and-quality: grille d’audit avant commit (gestion d’erreurs, concurrence, fuites de descripteurs, lisibilité).security-and-hardening: contrôle systématique des frontières de confiance (validation des entrées, absence de secrets en clair, durcissement OWASP).documentation-and-adrs: mise à jour synchrone des décisions d’architecture pour éviter la dérive documentaire.
–> Associés à Ponytail et Superpowers, ces skills empêchent l’agent de sauter les étapes de vérification lorsqu’il travaille sur un bug multi-services.
2. Pourquoi le format SKILL.md change la donne
Au lieu d’un prompt système monolithique de 50 pages qui dilue l’attention du modèle, chaque compétence est encapsulée dans un dossier .agents/skills/<nom>/SKILL.md avec un en-tête YAML déclaratif. L’orchestrateur ne lit les instructions détaillées d’une compétence que lorsque la tâche l’exige réellement : garantissant une exécution disciplinée, reproductible et économe en contexte.
| Commande | Description |
|---|---|
`.agents/skills/
| Emplacement modulaire chargé à la demande selon l'étape du cycle SDLC. |
`debugging-and-error-recovery`
| Activer dès qu'un test échoue : reproduire, isoler la cause racine, puis corriger. |
`code-review-and-quality`
| Exécuter une revue multi-axes sur le git diff avant tout commit en branche principale. |
`security-and-hardening`
| Vérifier les entrées non fiables, l'authentification et les dépendances tierces. |
3. Dépôt GitHub Officiel
- Addy Osmani Agent Skills (24 SDLC Skills) : https://github.com/addyosmani/agent-skills