Install
npx skills add mastra-ai/skillsÀ qui cela s’adresse
Convient à qui écrira des applications ou agents IA avec le framework Mastra et veut qu’un assistant de code suive les skills officielles. Texte officiel : ce sont des skills formelles pour les agents qui utilisent le framework Mastra. Mastra est un framework pour construire des applications et agents IA sur une pile TypeScript moderne. Site du framework :
https://mastra.ai/
Mieux adapté : qui a déjà un projet TypeScript / Mastra, ou s’apprête à développer avec la skill officielle d’ensemble. La source décrit le contenu comme une « skill d’ensemble unique » qui couvre les thèmes suivants par progressive disclosure et fichiers de référence ; ce paragraphe ne nomme pas ces fichiers.
Avant de commencer, il faut pouvoir exécuter npx skills add. Ne pas remplacer le chemin principal par un autre installateur non vérifié.
Réussir un premier essai en 3 minutes
Suivre uniquement la commande d’installation principale du dépôt. Le premier essai est une confrontation en lecture seule ; ne pas encore générer un nouvel agent de production.
Préalable : cette machine a déjà npm/npx, et vous avez votre projet TypeScript ou du code Mastra sur le point d’être initialisé. Ne pas inventer d’URL de dépôt d’exemple.
Emplacement d’installation : exécuter dans l’espace de travail :
npx skills add mastra-ai/skills
Dépôt officiel :
https://github.com/mastra-ai/skills
Déclencheur à faible risque : après installation, faire contrôler la structure Mastra existante selon cette skill d’ensemble, seulement dire quelles lignes officielles seront consultées, sans encore modifier de fichiers. Si l’assistant commence à créer un nouvel agent ou à écrire des appels réseau, confirmer d’abord les effets.
Succès : la skill est ajoutée, l’assistant parle du développement Mastra comme « skill d’ensemble unique », et aucun fichier non confirmé n’a été écrit. Si la skill n’apparaît pas, d’abord vérifier que la commande d’installation est complète ; ne pas passer à un nom de paquet non cité.
Cas d’usage
Cas 1 : contrôle de développement Mastra dans un projet TypeScript existant. Utiliser la skill officielle d’ensemble. Convient à qui a déjà un squelette d’application et veut compléter des capacités d’agent selon la skill formelle. La preuve ne parle que de progressive disclosure et de fichiers de référence, sans nommer les fichiers. Contrôler d’abord, puis décider de modifier le code.
Cas 2 : découverte via .well-known. Mastra prend aussi en charge cette norme de découverte ; la commande officielle supplémentaire est la suivante.
npx skills add https://mastra.ai/
Le dépôt sert les skills via une RFC 8615 Well-Known URI :
https://mastra.ai/.well-known/skills/
Notes de la norme :
https://github.com/cloudflare/agent-skills-discovery-rfc
Convient à qui veut découvrir des skills depuis le site du framework. C’est un second chemin d’installation ; ne pas le mêler à la commande principale dans la même opération. La preuve n’écrit pas quels fichiers arrivent après découverte.
Limites d’usage
La commande d’installation principale est npx skills add mastra-ai/skills. Le chemin .well-known est un complément, pas le premier essai par défaut.
La source ne décrit qu’une « skill d’ensemble unique » et ne nomme aucun dossier de skill. Ne pas inventer un chemin skills/ ni des noms de fichiers de référence.
Ce sont des skills officielles sur un framework TypeScript ; il n’y a pas d’étapes d’installation pour d’autres langages ni d’ensemble exclusif d’assistants.
Ne pas inventer d’URL hors de la documentation supplémentaire ; hors site du framework et page du dépôt, n’utiliser que l’adresse de découverte et le lien RFC de la source.