Compétences Agent

Les compétences apprennent à Agent de nouvelles capacités. Elles vous permettent de partager votre expertise, vos modèles préférés et vos connaissances spécialisées avec Agent afin qu’il produise des résultats meilleurs et plus cohérents.

​

Pourquoi les compétences sont importantes

Chaque fois que vous construisez avec Agent, vous créez un contexte utile : des solutions à des problèmes, des décisions de design, des préférences de framework. Mais ce contexte disparaît à la fin du chat. Les compétences le préservent. Une compétence d’animation GSAP apprend à Agent comment utiliser correctement une bibliothèque spécifique. Une compétence de système de design s’assure qu’il applique vos couleurs et règles d’espacement exactes. Une compétence de correction de bug capture une solution pour qu’Agent ne répète pas la même erreur. Les tâches qui étaient auparavant incohérentes deviennent fiables. Les compétences sont également un standard ouvert. Elles fonctionnent avec n’importe quel agent, y compris Replit Agent, vous pouvez donc les transporter entre les outils.

​

Compétences proactives vs. réactives

Un cadre de réflexion sur le moment et la façon de créer des compétences. Comprendre les deux modèles vous rend plus efficace.

​

Compétences proactives

Les compétences proactives sont celles que vous ajoutez avant de commencer à construire. Recherchez les bibliothèques ou modèles que vous souhaitez utiliser, trouvez ou créez des compétences pour eux, puis commencez à inviter. Exemple : Avant de construire un site portfolio avec des animations SVG dessinées à la main, recherchez des bibliothèques d’animation et trouvez GSAP. Installez une compétence GSAP React, puis invitez Agent à construire les animations. Agent dispose des connaissances spécialisées dont il a besoin dès le départ — il comprend l’API de la bibliothèque, les meilleures pratiques et les modèles courants. Sans la compétence, il pourrait produire quelque chose de générique ou incorrect. Ce modèle fonctionne bien lorsque :

• Vous utilisez une bibliothèque populaire mais avec des modèles nuancés qu’Agent peut ne pas maîtriser seul
• Vous souhaitez des choix de design cohérents dans tout le projet (typographie, espacement, style d’animation)
• Vous démarrez un projet et connaissez déjà la direction technique

​

Compétences réactives

Les compétences réactives sont celles que vous créez après avoir résolu un problème. Vous rencontrez un problème, le déboguez avec Agent, le corrigez, puis capturez la solution pour qu’elle ne se reproduise plus. Exemple : Lors de la construction d’un canvas pour une application mobile, vous remarquez des bords irréguliers sur les images qui s’aggravent lors du zoom avant. Le débogage avec Agent révèle qu’il s’agit d’un aliasing de minification — un problème de rendu où les images semblent pires à mesure qu’elles rétrécissent, paradoxalement. Après avoir implémenté un correctif, demandez à Agent de créer une compétence : Agent utilise l’historique de la conversation pour écrire une compétence spécifique au projet. La prochaine fois que le problème survient, vous pouvez diriger Agent vers la compétence au lieu de déboguer depuis le début. Ce modèle fonctionne bien lorsque :

• Vous avez corrigé un bug non évident et souhaitez empêcher sa récurrence
• Vous avez appris quelque chose sur l’architecture de votre application lors d’une session de débogage
• Vous souhaitez encoder une solution qui a nécessité un effort significatif à découvrir

​

Être sélectif avec les compétences

Pensez aux compétences comme des directions que vous donneriez à un ami pour trouver votre appartement. Une liste ciblée d’instructions fonctionne. Un classeur plein de documentation ne fonctionne pas — personne n’a le temps de lire ça, et les détails importants se perdent. La même chose s’applique à Agent. Si vous ajoutez trop de compétences, Agent peut être confus. Soyez délibéré sur les compétences que vous activez pour un projet donné, et supprimez celles dont vous n’avez plus besoin.

​

Bien rédiger des compétences

Les compétences peuvent être complexes et subtiles. Quelques principes les maintiennent efficaces :

• Décrivez le chemin heureux. Dites à Agent comment bien faire les choses. Si vous vous surprenez à lister ce qu’il ne faut pas faire, c’est généralement le signe que vous devriez reformuler l’approche entière.
• Utilisez des scripts autant que possible. Un script déterministe retire la réflexion des épaules d’Agent et est plus fiable que lui demander de raisonner à travers les mêmes étapes à chaque fois.
• Faites des liens. Structurez une compétence de sorte qu’elle pointe vers d’autres fichiers Markdown, et Agent n’intègre que ceux dont il a besoin pour la tâche en cours.
• Vérifiez régulièrement. C’est ainsi que vous confirmez qu’une compétence fonctionne réellement, plutôt que de le supposer.
• Rédigez-les vous-même. L’objectif est un contexte concis et délibéré, et vous y parvenez en rédigeant manuellement des compétences plutôt qu’en les générant en masse. Agent peut vous aider à en rédiger une, mais affinez-la vous-même pour que chaque ligne mérite sa place.
• Gardez-les sur mesure. Ne construisez pas de compétences génériques pour la propreté du code ou la sécurité — celles-ci sont déjà incluses avec Agent. Vos compétences doivent capturer ce qui est spécifique à vous ou votre organisation.

La plupart des compétences échouent de manière diagnosticable :

• Une compétence se déclenche alors qu’elle ne devrait pas. La description est trop large. Réduisez-la et indiquez quand ne pas l’utiliser — « pas pour les articles de blog ou la documentation d’aide » est souvent plus utile que toute instruction positive.
• Une compétence se déclenche mais la sortie est incorrecte. Les instructions sont trop génériques. Remplacez des conseils vagues comme « rendez-le professionnel » par des règles spécifiques : des noms exacts, des exigences concrètes, des choses explicites à éviter.
• Deux compétences entrent en conflit. Corrigez les descriptions afin que les deux ne se déclenchent pas sur la même tâche. Les conflits sont presque toujours un problème de portée, pas un problème d’instructions.

Les compétences se périment, alors traitez-les comme une documentation que vous maintenez réellement.

​

Étendre les compétences à l’ensemble de l’espace de travail

Tout ce qui précède s’applique aux compétences dans un seul projet. Dans une équipe, vous pouvez également personnaliser Agent pour l’ensemble de votre espace de travail, afin que tout le monde parte des mêmes conventions sans les réexpliquer dans chaque projet. La personnalisation de l’espace de travail comporte deux parties :

• Instructions personnalisées — des règles toujours actives injectées dans le contexte d’Agent pour chaque projet et chaque message, avant que quiconque ne saisisse une invite. Réservez-les aux quelques règles vraiment universelles, comme « ne jamais stocker les identifiants en texte clair ». Comme elles se chargent à chaque tour, chaque mot dépense une partie du budget de contexte d’Agent — gardez-les courtes.
• Compétences d’espace de travail — les mêmes compétences décrites ci-dessus, mises à la disposition de tous dans l’espace de travail et gérées de manière centralisée. Elles restent presque gratuites jusqu’à ce qu’une tâche pertinente les invoque, vous pouvez donc en proposer beaucoup sans dégrader la sortie.

Une façon simple de décider ce qui va où : si une règle doit s’appliquer quoi que construise quiconque, c’est une instruction personnalisée ; si elle ne compte que pour un certain type de tâche, c’est une compétence. Pour savoir comment configurer des instructions personnalisées et des compétences d’espace de travail, et qui peut les gérer, consultez Personnalisation d’Agent.

​

Considérations de sécurité

Les compétences du volet Compétences Replit sont auditées pour la sécurité. Mais les compétences peuvent être installées de n’importe où — elles proviennent d’un dépôt open source où n’importe qui peut contribuer. Puisque les compétences sont des instructions qu’Agent suit, une compétence malveillante pourrait dire à Agent d’exfiltrer des données sensibles de votre projet. Avant d’installer une compétence depuis une source externe :

1. Ouvrez le fichier. Les compétences sont juste du markdown. Lisez le contenu dans /.agents/skills/ avant de les utiliser.
2. Vérifiez la source. Assurez-vous que la compétence provient d’un dépôt ou d’un auteur de confiance.
3. Examinez ce qu’elle instruit. Assurez-vous que la compétence ne référence pas des URL externes suspectes ou ne demande pas d’informations sensibles.

​

Compétences vs. serveurs MCP

Les compétences et les serveurs MCP sont les deux principales façons d’étendre les agents, et ils servent des objectifs différents. Les compétences sont efficaces en contexte. Seule une brève description se charge jusqu’à ce que la compétence soit invoquée. Utilisez les compétences pour :

• Les flux de travail et conventions (« comment déployer », « liste de vérification pour la révision de code »)
• Les matériaux de référence (modèles d’API, guides de style, systèmes de design)
• Les invites réutilisables et les connaissances spécialisées (bibliothèques d’animation, modèles de framework)

Les serveurs MCP sont gourmands en contexte. Toutes les descriptions d’outils se chargent à l’avance, ce qui peut dégrader la qualité de la sortie si vous en ajoutez trop. Utilisez les serveurs MCP pour :

• Se connecter à des services externes (Notion, Linear, Figma)
• Les actions nécessitant un accès API
• Les outils qui font des choses, et pas seulement qui instruisent

La distinction clé : les compétences définissent comment votre agent doit fonctionner. Les serveurs MCP définissent ce à quoi votre agent peut accéder. Les deux fonctionnent pour les agents de codage comme Replit Agent et pour les agents que vous construisez vous-même.

​

Prochaines étapes