Un agent IA Laravel dont les instructions dépassent quelques paragraphes gagne à les découper en "skills" : des dossiers que le modèle n'ouvre que si la question l'exige. C'est ce qu'ajoute le Laravel AI SDK 1.1, sorti début octobre 2026. Pour un agent au prompt court, le gain est négligeable et la mécanique inutile.
Le point de départ : des instructions qui enflent
Un assistant métier démarre avec deux lignes. Puis s'invitent les règles de remboursement, celles de livraison, le ton de la marque, une pile d'exemples de réponses. Tout part au modèle à chaque requête, même quand le client demande seulement où est son colis.
Le fournisseur facture en tokens, ces petits morceaux de mots qui servent d'unité de compte. Plus le prompt grossit, plus chaque échange pèse. Et plus il devient pénible à relire.
Étape 1 : un sommaire toujours visible, des chapitres à la demande
Un skill est un dossier de resources/skills contenant un fichier SKILL.md : une description courte en tête, les instructions complètes dessous. Le principe vient d'Anthropic, qui le décrit en trois niveaux : nom et description toujours présents, corps du fichier si pertinent, fichiers annexes seulement sur demande. Anthropic le présente comme un standard ouvert, c'est-à-dire un format publié que d'autres outils peuvent reprendre.
Côté Laravel, l'agent déclare ses sources de skills et le SDK lui ajoute un outil nommé LoadSkill. Selon Laravel News, une source peut être un dossier, un objet PHP ou une closure, exécutée seulement au premier accès. On peut donc charger des skills depuis la base, par utilisateur ou par client.
Le modèle voit le sommaire en permanence. Il n'ouvre un chapitre que s'il en a besoin.
L'alternative, c'est de tout laisser dans les instructions de l'agent. Plus simple, rien à configurer, mais tout repart à chaque requête.
Étape 2 : ce que la mise en place demande
Une commande Composer (laravel/ai:^1.1), PHP 8.3 ou plus, Laravel 12 ou 13, et la bibliothèque symfony/yaml pour lire les fichiers. Le package est gratuit, les tokens restent facturés par le fournisseur du modèle.
Côté preuves, c'est maigre : aucune mesure d'économie sur Laravel dans les sources que nous avons lues, ni retour d'usage en production. Des éditeurs tiers avancent des ordres de grandeur de tokens par skill, mais rien n'est vérifié sur ce SDK.
Étape 3 : les pièges avant la production
L'auteur de l'article dev.to a lu le code, sans modèle réel, et relève plusieurs écueils :
- un
SKILL.mdsans description, ou sans frontmatter (l'en-tête du fichier), est ignoré sans aucune erreur ; - un seul niveau de dossier est scanné ;
- en cas de nom en double, la première source gagne.
Deux autres points nous semblent plus lourds. Le modèle décide seul de charger un skill d'après sa description : il peut ne pas le faire, ou le faire à tort. Il faut donc tester le déclenchement avec de vraies questions, celles que vos clients posent. Et chaque chargement ajoute un aller-retour, dont le coût n'est pas mesuré.
Reste la mise à jour elle-même. Elle change les modèles par défaut (Anthropic passe à claude-sonnet-5-5, Gemini à gemini-3.8-flash). Fixez le modèle dans config/ai.php avant, sinon vous changez de comportement et de coût sans l'avoir décidé.
Ce qu'une PME peut en retenir
Chez nous, un agent propose et un humain valide. Séparer les règles métier en fichiers rangés par thème va dans ce sens : elles se versionnent dans le dépôt et se relisent comme du code, au même titre que le reste de l'application. Sur un assistant qui prépare des devis et des factures, comme celui de Making One, ce découpage serait une piste naturelle, toujours avec validation humaine avant envoi.
Nous le déconseillons à trois profils. L'agent au prompt court, où il n'y a rien à alléger. L'équipe qui n'a pas le temps de tester le déclenchement. Et tout montage où une closure charge du texte modifiable par des utilisateurs : Anthropic avertit qu'un skill malveillant peut pousser l'agent à exfiltrer des données. Un skill se traite comme du code.
Nous accompagnons des entreprises de Provence, du côté de Marignane comme ailleurs, sur ce genre d'arbitrage. Notre page Laravel et IA détaille ce que nous construisons, et celle sur les agents IA sur mesure la façon dont nous cadrons un premier cas d'usage. Sur le coût global d'une application IA, un autre article regarde le cache et le routage.
- Les skills chargent les instructions à la demande : utiles seulement si elles sont longues et hétérogènes.
- Aucun gain de tokens n'est mesuré sur Laravel à ce jour : testez sur vos vraies questions.
- Fixez le modèle dans
config/ai.phpavant la mise à jour 1.1. - Un skill sans description est ignoré sans erreur, et se traite comme du code.
Questions fréquentes
Un skill remplace-t-il les instructions de mon agent ?
Non, il les complète. Les consignes générales restent dans l'agent, et les blocs spécialisés (remboursement, livraison, ton) passent dans des skills chargés seulement quand la question s'y rapporte.
Le Laravel AI SDK 1.1 est-il payant ?
Le package est gratuit. Ce qui se facture, ce sont les tokens consommés chez le fournisseur du modèle. Nous n'avons pas trouvé de tarif propre aux skills.
Combien de tokens économise-t-on avec les skills ?
Aucune source lue ne le mesure sur Laravel. L'économie dépend de la taille de vos instructions : pour un prompt court, elle est nulle.
Peut-on réutiliser ces skills avec un autre outil ?
En partie. Le format SKILL.md vient d'Anthropic, qui le présente comme un standard ouvert, et le SDK peut pointer vers un dossier .agents/skills utilisé par l'agent de code d'un développeur.