Les Agent Skills d’Antigravity Google offrent une solution pragmatique au “Tool Bloat” : la surcharge contextuelle qui ralentit les agents IA. En chargeant uniquement les compétences pertinentes à la demande, elles réduisent les coûts token et améliorent la fiabilité. Un changement discret, mais décisif pour rendre les agents IA plus efficaces en production.
Le Tool Bloat : quand la puissance devient un fardeau
Imaginez un assistant doté de plus de cent capacités différentes. GitHub MCP en propose 50. Playwright en ajoute 24. Chrome DevTools en apporte 26. Avant même de traiter la première demande de l’utilisateur, l’agent a déjà consommé 40 à 50 milliers de tokens rien qu’à énumérer ce qu’il sait faire. C’est le piège du Tool Bloat.
Google Antigravity v1.14.2 vient de rompre ce cercle vicieux avec les Agent Skills, une approche qui repense la manière dont les agents accèdent à leurs capacités. Plutôt que de charger tous les outils au démarrage, les Skills ne se déploient que lorsque le contexte les rend pertinents. Pas de révolution technologique, mais une réponse pragmatique à une tension architecturale que les développeurs vivent quotidiennement : comment donner aux agents l’accès complet à leurs outils sans les paralyser sous le poids de leurs propres capacités.
La surcharge quantitative
Chaque outil, chaque fonction, chaque endpoint consomme des tokens. Un agent qui démarre une session avec GitHub MCP (50 outils), Playwright (24 outils) et Chrome DevTools (26 outils) brûle 40 à 50 milliers de tokens uniquement pour décrire ses capacités. Avec les modèles facturés à l’usage — même dotés d’immenses context windows comme Gemini 3 avec son million de tokens — ce surcoût s’accumule rapidement. À l’échelle d’une équipe, sur des mois d’exécution agentic continu, le coût devient prohibitif.
La confusion qualitative
Un contexte surchargé désoriente le modèle. Présenté avec 100 outils, l’agent hésite sur chaque décision. Doit-il choisir le parseur JSON ou la requête SQL ? La commande shell ou l’API REST ? Ce brouillage — que les chercheurs appellent Context Saturation — se traduit par trois conséquences immédiates : une latence accrue (le modèle traite davantage de distractions avant de choisir), une fiabilité dégradée (les outils erratiques, les hallucinations sur l’existence de fonctions qui n’existent pas) et une capacité de raisonnement affaiblie.
Ce problème n’était pas nouveau, mais il devient critique avec l’émergence des agents agentics — des systèmes qui orchestrent des flux de travail autonomes plutôt que de répondre à des questions ponctuelles. Un agent exécutant une suite de 10 tâches successives doit conserver toutes ses capacités disponibles. Le coût devient dissuasif.
Progressive Disclosure : la philosophie des Agent Skills
Antigravity répond par une inversion de modèle : au lieu de charger d’emblée toutes les instructions et tous les outils, l’agent reçoit une liste légère, essentiellement des métadonnées (nom, description courte). Si la tâche en cours rend une capacité pertinente, l’agent ne la charge alors que le contenu lourd : les procédures détaillées, les exemples, les scripts. Une fois la tâche terminée, ce contenu peut être libéré du contexte.
Cette stratégie, appelée Progressive Disclosure, repose sur trois piliers.
Légèreté. Une Agent Skill n’est pas un serveur. C’est un dossier contenant un unique fichier `SKILL.md`, une description en Markdown enrichie de métadonnées YAML. Pas de backend avec état, pas d’architecture client-serveur statique. C’est éphémère : la skill existe pendant qu’on en a besoin, puis disparaît du contexte.
Découvrabilité sémantique. L’agent ne reçoit pas une liste exhaustive de commandes à mémoriser. Il accède à des descriptions : « Génère des tests unitaires pour du code Python en utilisant les conventions pytest. » Si l’utilisateur demande « Écris-moi des tests », l’agent reconnaît la pertinence via correspondance sémantique, pas via décodage syntaxique laborieux.
Modularité. Une Skill encapsule non seulement des instructions, mais aussi les ressources : templates, exemples, scripts d’exécution. Tout ce qui était autrefois dispersé dans des dossiers épars ou fondu dans des prompts système devient versionnable, localisé et composable.
Anatomie d'une Skill : du minimaliste à l'élaboré
Structure minimale
La base est triviale : un dossier nommé selon votre capacité (ex. `git-commit-formatter/`) contenant un fichier `SKILL.md`.
Ce fichier combine du YAML frontmatter (métadonnées) et du Markdown (contenu).
Architecture progressive
Au-delà de cette base, les Skills s’enrichissent graduellement. Antigravity supporte quatre répertoires optionnels qui allongent la complexité et l’utilité :
| Répertoire | Usage | Exemple |
|---|---|---|
| `scripts/` | Exécutables pour tâches déterministes | Validation SQL, reformatage JSON |
| `examples/` | Fichiers d’exemple pour few-shot learning | Paires entrée/sortie pour transformations |
| `resources/` | Templates, configurations ou fichiers statiques | Textes de licence, modèles de configuration |
| `README.md` | Documentation pour les humains | Guide d’utilisation, bonnes pratiques |
Les cinq paliers d'évolution des Skills
Romin Irani, Developer Advocate chez Google, a structuré l’évolution des Skills en cinq niveaux progressifs qui correspondent à des besoins croissants.
Niveau 1 : Le Routeur Basique
Contenu : Instruction seule dans `SKILL.md`. Coût : ~200–400 tokens.
Pour une procédure mentale claire, sans besoin d’exemple ou de script. Exemple : `git-commit-formatter` avec règles Conventional Commits.
Niveau 2 : Utilisation d’Assets
Contenu : Instruction + fichiers externes dans `resources/`. Coût : ~200–400 tokens + token-on-demand.
Quand l’agent doit injecter des templates ou des fichiers inchangés. Exemple : `license-header-adder` avec fichiers de licence Apache/MIT/GPL.
Niveau 3 : Few-Shot Learning
Contenu : Instruction + exemples dans `examples/`. Coût : ~200–400 tokens + ~500–1000 tokens pour exemples.
Quand le modèle doit voir des entrées/sorties réelles pour généraliser. Exemple : `json-to-pydantic` avec paires JSON/schémas.
Niveau 4 : Exécution Déterministe
Contenu : Instruction + scripts dans `scripts/`. Coût : ~200–400 tokens + surcharge d’exécution.
Pour les tâches nécessitant des résultats certains. Exemple : `database-schema-validator` avec script de validation SQL.
Niveau 5 : Le Scaffold Complet
Contenu : Tous les éléments combinés. Coût : ~500–1000 tokens ou plus.
Pour les workflows complexes avec génération de structure. Exemple : `adk-tool-scaffold` avec templates, exemples et scripts.
L'écosystème Antigravity : clarifier les frontières
Les Skills ne vivent pas isolées. Trois concepts cousins peuplent l’univers Antigravity et méritent d’être distingués clairement.
Rules vs Skills. Les Rules sont des contraintes passives, toujours actives ou déclenchées par type de fichier. Les Skills s’activent sémantiquement selon le raisonnement de l’agent.
Workflows vs Skills. Les Workflows orchestrent des séquences de tâches lancées par l’utilisateur, de manière déterministe. Les Skills répondent au raisonnement autonome de l’agent en fonction du contexte.
MCP Tools vs Skills. Les outils MCP sont les “mains” de l’agent : des fonctions déterministes pour manipuler l’extérieur. Les Skills sont le “cerveau” : elles décident quand et comment utiliser ces outils.
Bonnes pratiques de conception
Décrire sans équivoque
Le champ `description` est votre levier principal d’activation. Elle doit communiquer précisément quand l’agent doit activer la Skill.
Mauvaise description : « Aide avec les commits. »
Bonne description : « Reformate les messages de commit selon la spécification Conventional Commits (feat, fix, refactor, etc.). Utilise-la quand l’utilisateur demande la standardisation, le nettoyage ou l’explication de messages de commit. »
Trois principes fondamentaux
Chaque script doit incarner une responsabilité unique. Un script = une action. Le fichier `SKILL.md` doit rester léger (maximum 1000 caractères), avec relocalisation du contenu si besoin. Testez toujours la Skill dans Antigravity avant partage.
Trois pièges courants
Les descriptions vagues empêchent l’activation. Les scripts avec effets de bord dangereux créent des risques. Oublier les exemples pour transformations complexes rend la Skill inefficace. Surcharger d’outils externes dilue la responsabilité.
Antigravity Skills vs Claude Skills : le comparatif
| Aspect | Antigravity Skills | Claude Skills |
|---|---|---|
| **Emplacement** | Dans l’IDE, fichiers versionables | API Projects, contexte chat |
| **Versioning** | Intégré au codebase | Moins versionable, moins transparent |
| **Parallélisme** | Multi-agents simultanés (Mission Control) | Single-threaded, séquentiel |
| **Coût (2026)** | Subsidié par Google, viable économiquement | Prohibitif pour usage permanent |
Verdict : Un développeur solo trouvera Claude plus simple. Les grandes équipes et les projets complexes gagneront avec Antigravity.
Guide de mise en œuvre pratique
Créer votre première Skill
Minimal viable SKILL.md
Déploiement
Workspace-specific : `.agent/skills/my-first-skill/`
Globale : `~/.gemini/antigravity/skills/my-first-skill/`
Test immédiat
Dans Antigravity : « Formate ‘bonjour le monde’ » ou « Convert ‘bonjour le monde’ to Title Case ». L’agent reconnaît la pertinence et active la Skill.
Conclusion : structurer sans étouffer
Les Agent Skills ne révolutionnent pas l’IA. Elles offrent une réponse calibrée à un problème réel : comment factoriser les capacités d’un agent sans charger un contexte intolérable. Pour le développeur, c’est une victoire quotidienne : chaque requête traitée plus vite, chaque token économisé, chaque décision d’agent plus claire.
Les bénéfices clés restent concrets : réduction des coûts token et de la latence, amélioration de la fiabilité des agents, meilleure modularité et maintenabilité, intégration fluide avec Rules, Workflows et MCP.
Le chemin d’adoption est tracé : commencez par une Skill minimaliste, testez localement, enrichissez progressivement selon les vrais besoins. Versionnez et partagez dans votre équipe. Avec Antigravity qui rend ces Skills accessibles et le MCP Store qui grandit, l’IDE devient un véritable hub contextuel. L’agent puise du contenu réel plutôt que de guider en aveugle. C’est le futur du développement agentic : moins de surcharge, moins de coûts, plus de clarté dans chaque décision.
FAQ
Qu'est-ce que le Tool Bloat dans les agents IA ?
Le Tool Bloat désigne la surcharge contextuelle causée par le chargement indiscriminé de tous les outils disponibles, consommant jusqu’à 50k tokens et réduisant les performances.
Comment fonctionnent les Agent Skills ?
Elles utilisent la “Progressive Disclosure” : seules les métadonnées sont chargées initialement, le contenu détaillé l’est uniquement si pertinent.
Quels sont les avantages des Agent Skills ?
Réduction des coûts token, amélioration de la latence et de la fiabilité, et meilleure modularité des compétences agentiques.
Sources
- https://antigravity.google/docs/skills
- https://medium.com/google-cloud/tutorial-getting-started-with-antigravity-skills-864041811e0d
- https://www.reddit.com/r/google_antigravity/comments/1qcfw7k/google_antigravity_skills_like_claude_skills_w_a/
- https://www.tonyreviewsthings.com/google-antigravity-skills-mcp-agentic-ide/
- https://github.com/rominirani/antigravity-skills









