Aller au contenu principal

Skills

Les Skills enseignent une procédure précise grâce à des instructions réutilisables. Un Skill peut contenir SKILL.md, des fichiers associés et une commande dans les conversations compatibles.

Sources des Skills​

Dashboard les regroupe par origine :

SourceSignification
SystemFourni avec Anyy ; visible mais non désactivable/supprimable par l’utilisateur
User InstalledInstallé dans la racine gérée du profil
Agent CreatedProvenance gérée d’un enregistrement créé par une procédure capable d’agent

Les Skills appartiennent au profil. Un autre profil a son catalogue et ses activations.

Installez depuis Dashboard ou demandez une source précise dans une conversation. Avec skill_manage, elle écrit dans la bibliothèque gérée sélectionnée, identique à celle de Dashboard/CLI.

Installer depuis une conversation​

Donnez le chemin d’un paquet .zip local fiable accessible sur l’hôte et demandez son installation. Actualisez ensuite Dashboard → Skills et inspectez source, activation et contenu.

L’inverse fonctionne aussi : installez depuis Dashboard puis demandez son usage dans le même profil. La demande suivante peut découvrir le catalogue rechargé et lire SKILL.md ; une demande déjà active garde son contexte admis. Un message de réussite ne suffit pas si le Skill manque de la page ou reste illisible dans la conversation.

Inspecter un Skill​

Ouvrez Dashboard → Skills, puis un Skill pour :

  • ID, nom, description et périmètre ;
  • source et état géré ;
  • activation ;
  • contenu rendu de SKILL.md ;
  • chemin ;
  • fichiers liés.

Lisez les instructions avant activation ou installation d’un tiers. Un Skill influence les commandes demandées et les outils sélectionnés.

Activer ou désactiver​

Utilisez le commutateur d’un Skill non système. La désactivation le retire de la résolution normale sans supprimer ses fichiers. Réactivez-le pour le rendre disponible.

Rechargez après des modifications externes. La prochaine demande utilise le nouveau catalogue ; une demande admise garde ses instructions. Vérifiez séparément l’activation : remplacer un Skill désactivé ne l’active pas.

Installer depuis Dashboard​

Choisissez Install Skill et importez un .zip local contenant exactement un Skill : SKILL.md à la racine avec fichiers associés, ou un unique répertoire de Skill.

La requête complète, surcharge multipart comprise, doit tenir dans 10 Mio. Le ZIP et son contenu extrait ont aussi cette limite. La validation rejette traversées, liens symboliques, fichiers spéciaux et entrées hors racine de préparation. Le nom de SKILL.md contient au maximum 64 minuscules/chiffres reliés par des traits d’union simples, comme release-notes ; ce ne peut être un chemin. Utilisez ce nom pour le répertoire englobant. L’installation remplace le Skill géré de même nom.

Le service résident vérifie ID d’import, SHA-256 et expiration dans le profil, applique le paquet et recharge. Seuls les ZIP locaux sont acceptés. Sources GitHub, URL distantes, répertoires locaux et collections ne sont pas installables ; les métadonnées historiques des Skills existants restent disponibles.

Accorder aux Skills une confiance comparable au code

Examinez instructions, commandes, téléchargements externes et fichiers référencés avant installation. La validation contrôle la structure ; vous décidez de la confiance à accorder aux instructions.

Supprimer un Skill​

Remove Skill dans le détail supprime un Skill géré du profil et recharge le catalogue. Les Skills système ne peuvent pas être retirés depuis Dashboard.

Gestion CLI​

La CLI installe un ZIP local accessible à l’hôte et utilise les mêmes bibliothèque et validation.

anyy skills list
anyy skills view weather
anyy skills install ./weather.zip
anyy skills uninstall weather
anyy skills rollback weather
anyy skills reload

Options utiles :

  • --force remplace un Skill géré existant ;
  • --now demande un rechargement après modification hors ligne ; les mutations RPC résidentes rechargent déjà ;
  • --revision ID restaure une révision immuable précise ;
  • --json retourne une sortie structurée.

Sans --revision, la restauration choisit la révision gérée précédente. Hors ligne, la modification exige l’absence de propriétaire résident ; sans Gateway, les fichiers sont découverts au démarrage suivant. Les mutations de conversation rechargent normalement aussi ; si skill_manage utilise reload:false ou signale reload_error, rechargez avant de compter sur le catalogue.

Utiliser un Skill​

Tapez /skills dans la TUI ou / dans Dashboard Chat pour le catalogue actif. Les Skills peuvent ajouter des commandes canoniques. La liste dépend du profil, de l’interface, de la plateforme et des activations.

Dépannage​

ProblèmeSolution
Installation échouéeVérifiez source/erreur d’import et profil
Skill absent de la conversationConfirmez profil et activation, inspectez les erreurs puis soumettez une nouvelle demande avec lecteur read ou bash
ZIP rejetéVérifiez nom et structure unique, retirez liens/échappements et gardez de la marge multipart dans 10 Mio
Désinstallation/restauration bloquéeUtilisez le résident ou arrêtez Anyy avant modification hors ligne
Skill système non commutableLes Skills système sont gérés par la version Anyy

Gardez la configuration des capacités dans Tools ; un Skill n’accorde pas seul outils ou autorisations.