Guide complet d'Agent Skills : boostez votre productivité de développement IA avec le framework open source d'Addy Osmani

Qu'est-ce qu'Agent Skills ?

Agent Skills est un framework open source créé par Addy Osmani (ingénieur senior dans l'équipe Google Chrome, expert reconnu dans le domaine des performances web). Son objectif est de fournir des compétences d'ingénierie de niveau production et des meilleures pratiques aux assistants de programmation IA (comme Claude Code, Cursor, Windsurf, etc.).

En termes simples, Agent Skills encode les workflows, les portes de qualité et les meilleures pratiques utilisés par les ingénieurs logiciels seniors lors du développement en packages de compétences réutilisables. Cela permet aux AI Agents de maintenir des standards élevés et cohérents à chaque étape du développement, comme le ferait un ingénieur expérimenté.

Pourquoi avons-nous besoin d'Agent Skills ?

Les assistants de programmation IA actuels (Claude Code, Codex, Gemini CLI, etc.) peuvent générer du code. Mais ils manquent souvent d'une pensée d'ingénierie systématique :

• ❌ Ils écrivent directement du code, sans d'abord rédiger de spécifications (Spec)
• ❌ Ils implémentent trop de fonctionnalités d'un coup, avec des tâches trop larges
• ❌ Ils n'ont pas conscience du développement piloté par les tests
• ❌ Les revues de code restent superficielles
• ❌ Aucune vérification approfondie avant le déploiement

Agent Skills mappe le cycle de vie complet du développement via 7 commandes Slash. Chaque commande active automatiquement le module de compétence correspondant :

Points forts du projet

• 🚀 Plus de 38 971 stars sur GitHub, communauté très active
• 🔧 Supporte plusieurs plateformes IA : Claude Code, Cursor, Windsurf, OpenClaw, etc.
• 📦 Design modulaire : chaque compétence est encapsulée indépendamment, activable selon les besoins
• 🎯 Déclenchement automatique : active les compétences pertinentes selon le contexte (par exemple, api-and-interface-design se déclenche automatiquement lors de la conception d'une API)
• 🆓 Entièrement open source et gratuit : licence MIT

Installation d'Agent Skills

Prérequis

• Claude Code ou un autre assistant de programmation IA supporté installé
• Un compte GitHub (pour l'installation via Marketplace)

Méthode 1 : Installation via Claude Code Marketplace (recommandée)

# Ajouter le plugin
/plugin marketplace add addyosmani/agent-skills

# Installer
/plugin install agent-skills@addy-agent-skills

Si vous rencontrez une erreur SSH (Marketplace clone par défaut via SSH), utilisez plutôt l'URL HTTPS :

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

Méthode 2 : Installation locale (idéale pour le débogage développeur)

# Cloner le dépôt
git clone https://github.com/addyosmani/agent-skills.git

# Démarrer Claude Code en spécifiant le répertoire des plugins
claude --plugin-dir /path/to/agent-skills

Méthode 3 : Pour les utilisateurs de Cursor

Pour les utilisateurs de l'éditeur Cursor, copiez n'importe quel fichier SKILL.md dans le répertoire .cursor/rules/ :

# Copier tous les fichiers de compétences
cp -r agent-skills/skills/* ~/.cursor/rules/

Vous pouvez également référencer le dépôt distant dans les paramètres de Cursor.

Méthode 4 : Autres assistants IA

Le cœur d'Agent Skills repose sur des fichiers de description de compétences au format Markdown (SKILL.md). En théorie, tout assistant de programmation IA supportant des règles personnalisées peut les utiliser :

• Windsurf : placez SKILL.md dans .windsurfrules/
• OpenClaw : consultez la structure du répertoire skills/ du projet
• Agents personnalisés : parsez SKILL.md et injectez-le dans le prompt système

Fonctionnalités principales en pratique

1. /spec — Spécifications d'abord, code ensuite

C'est l'un des concepts les plus importants d'Agent Skills : avant d'écrire le moindre code, clarifiez ce que vous allez construire.

Utilisation :

/spec Je veux construire une API REST qui supporte l'inscription utilisateur, la connexion et l'authentification JWT

L'IA générera un document de spécifications structuré, incluant :

• Liste des exigences fonctionnelles
• Conception des points de terminaison API
• Définition des modèles de données
• Justification du choix de la stack technique
• Critères d'acceptation

Extrait de sortie exemple :

## Spécifications de l'API

### Conception des endpoints

- POST /api/auth/register
  - Corps de requête: { email, password, name }
  - Réponse: { userId, token }
  - Erreurs: 409 (email déjà existant), 400 (mot de passe trop faible)

- POST /api/auth/login
  - Corps de requête: { email, password }
  - Réponse: { token, expiresIn }

### Modèles de données

User:
  - id: UUID
  - email: string (unique, indexé)
  - password_hash: string (bcrypt)
  - created_at: timestamp

2. /plan — Tâches petites et atomiques

Une fois les spécifications rédigées, ne vous précipitez pas pour coder. Utilisez d'abord /plan pour décomposer la grande tâche en sous-tâches petites et atomiques. Chaque tâche devrait :

• Pouvoir être complétée en 15 à 30 minutes
• Avoir des entrées et sorties clairement définies
• Être testable indépendamment

Utilisation :

/plan Sur la base des spécifications ci-dessus, planifiez les étapes d'implémentation

L'IA générera une liste de tâches comme celle-ci :

## Plan d'implémentation

### Phase 1 : Initialisation du projet
- [ ] Task 1.1 : Initialiser le projet Node.js, installer express, jsonwebtoken, bcrypt
- [ ] Task 1.2 : Configurer ESLint + Prettier
- [ ] Task 1.3 : Mettre en place la connexion à la base de données (PostgreSQL + Prisma)

### Phase 2 : Modèle utilisateur
- [ ] Task 2.1 : Définir le schéma User
- [ ] Task 2.2 : Écrire les tests unitaires : création d'utilisateur, recherche d'utilisateur

### Phase 3 : Logique d'authentification
- [ ] Task 3.1 : Implémenter les fonctions utilitaires de hachage de mot de passe
- [ ] Task 3.2 : Implémenter la génération et la validation JWT
- [ ] Task 3.3 : Écrire les tests d'intégration : inscription → connexion → validation du token
...

3. /build — Construction incrémentale

C'est l'une des commandes les plus puissantes. /build génère automatiquement un plan et exécute toutes les tâches une par une. Vous n'avez qu'à approuver le plan une fois, puis il peut s'exécuter de manière autonome.

Concepts de design clés : - ✅ Supprime les étapes fastidieuses de confirmation manuelle progressive - ✅ Conserve le développement piloté par les tests et les commits indépendants pour chaque tâche - ✅ Suspend automatiquement en cas d'échec ou d'étapes à haut risque

Utilisation :

/build Implémenter le plan ci-dessus

L'IA va : 1. Afficher le plan complet pour votre approbation 2. Une fois approuvé, exécuter les tâches une par une 3. Exécuter automatiquement les tests après chaque tâche terminée 4. Soumettre un commit git après succès des tests 5. Suspendre et attendre une intervention humaine en cas d'erreur

4. /test — Les tests sont la preuve

Agent Skills met l'accent sur le développement piloté par les tests (TDD). Avant toute modification de code, assurez-vous d'avoir les tests correspondants.

Utilisation :

/test Écrire des tests pour la nouvelle interface d'inscription utilisateur

L'IA générera : - Tests unitaires (Jest/Vitest) - Tests d'intégration (Supertest) - Tests de cas limites (valeurs nulles, emails dupliqués, mots de passe faibles, etc.)

5. /review — Améliorer la santé du code

Avant de fusionner le code, utilisez /review pour effectuer une revue de code. Cela ne se limite pas à vérifier les bugs, mais examine aussi :

• La lisibilité du code
• Les risques de performance
• Les vulnérabilités de sécurité
• La cohérence architecturale

Utilisation :

/review Réviser la PR #42 récente

6. /code-simplify — La clarté l'emporte sur l'intelligence

Cette compétence est spécialement conçue pour refactoriser du code complexe, en suivant le principe « la clarté l'emporte sur l'intelligence ».

Utilisation :

/code-simplify Simplifier la logique dans auth.middleware.js

L'IA va : - Extraire les longues fonctions en petites fonctions - Éliminer les conditions trop profondément imbriquées - Remplacer les noms de variables obscurs par des noms plus intuitifs - Ajouter les commentaires nécessaires

7. /ship — Plus rapide et plus sûr

Dernière vérification avant le déploiement. /ship s'assure que :

• Tous les tests passent
• Aucun changement non commité n'existe
• Le pipeline CI/CD fonctionne normalement
• Le plan de rollback est prêt

Utilisation :

/ship Préparer le déploiement en environnement de production

Compétences à déclenchement automatique

En plus des commandes Slash appelées manuellement, Agent Skills active automatiquement les compétences pertinentes selon le contexte :

Cela signifie que vous n'avez pas besoin de mémoriser toutes les commandes. Décrivez simplement votre tâche naturellement, et Agent Skills associera automatiquement les meilleures pratiques appropriées.

Compétences personnalisées

Le design d'Agent Skills est modulaire. Vous pouvez créer vos propres compétences. Chaque compétence est un fichier SKILL.md contenant :

---
name: my-custom-skill
description: Description de ma compétence personnalisée
---

## Quand l'utiliser

Utilisez cette compétence lorsque les conditions suivantes sont remplies :
- Condition 1
- Condition 2

## Étapes d'exécution

1. Première étape
2. Deuxième étape
3. ...

## Points d'attention

- Point 1
- Point 2

Placez simplement le fichier dans le répertoire skills/ pour qu'il soit actif.

Comparaison avec d'autres outils

Le plus grand avantage d'Agent Skills est son ouverture et son écosystème communautaire — n'importe qui peut contribuer des compétences, formant ainsi une bibliothèque partagée de meilleures pratiques.

Résumé

Agent Skills représente la prochaine évolution des assistants de programmation IA : passer de « capable d'écrire du code » à « maîtriser l'ingénierie ».

En encodant l'expérience des ingénieurs seniors en packages de compétences réutilisables, il transforme l'AI Agent d'un simple générateur de code en un véritable partenaire d'ingénierie doté d'une pensée systématique.

Parcours de lecture recommandé :

1. Commencez par lire la documentation officielle pour découvrir la liste complète des compétences
2. Débutez avec /spec et /plan pour cultiver l'habitude de « réfléchir avant de coder »
3. Essayez /build pour expérimenter le charme de l'exécution automatisée
4. Personnalisez ou contribuez à de nouvelles compétences selon vos besoins

Pour les développeurs utilisant actuellement Claude Code, Cursor ou d'autres assistants de programmation IA, Agent Skills est un multiplicateur de productivité qui vaut vraiment la peine d'y consacrer du temps d'apprentissage.

Liens connexes :

• Dépôt GitHub Agent Skills
• Site personnel d'Addy Osmani
• Documentation officielle Claude Code