Le format de compétence ClawHub

Le format de compétence ClawHub est presque agressivement simple, et cette simplicité porte le reste : une compétence est un dossier, et le seul fichier qu’elle doit contenir est SKILL.md. Tout ce que le registre en sait ensuite vient d’un unique bloc YAML en tête de ce fichier.

Ce que contient le dossier

• SKILL.md est obligatoire, avec skill.md accepté comme graphie alternative et l’ancien skills.md toujours honoré.
• N’importe quels fichiers d’appui ordinaires peuvent l’accompagner, et la publication les accepte quelle que soit leur extension, sous réserve des fichiers d’exclusion, des chemins cachés, des liens symboliques et des plafonds de taille côté serveur.
• Un .clawhubignore contrôle ce que la publication saute, et un .gitignore est également honoré, ce qui veut dire qu’un dossier déjà propre pour git l’est généralement déjà pour le registre.
• Le CLI écrit ses propres métadonnées d’installation dans un répertoire .clawhub à côté de la compétence et un fichier de verrou dans le répertoire de travail : ce sont des sorties, pas des choses que vous rédigez.

Les analyseurs de sécurité reçoivent l’artefact stocké complet ; la détection de texte relève du rendu et de l’analyse, ce n’est pas une liste blanche de téléversement.

L’en-tête EST la fiche

Les métadonnées se déclarent dans l’en-tête YAML en tête de SKILL.md, et le serveur les extrait à la publication. La description devient le résumé de la compétence partout où elle apparaît, dans l’interface et dans la recherche, donc c’est la seule ligne sur laquelle la plupart des lecteurs la jugeront. Les exigences d’exécution vont sous un bloc metadata.openclaw, qui est ce qui dit au registre comme à l’analyse de sécurité ce dont la compétence a réellement besoin pour tourner.

Le nommage, et les deux limites

• Pour une compétence d’agent portable, le nom devrait correspondre au dossier parent et utiliser de une à soixante-quatre lettres minuscules, chiffres ou tirets.
• ClawHub garde séparés l’identifiant routable et le nom d’affichage du catalogue, donc un nom venu d’un autre client reste publiable et n’est jamais réécrit en silence, même si un nom long peut être raccourci visuellement sans changer ce qui est stocké.
• Deux limites côté serveur comptent : le paquet total est plafonné à 50 Mo, et le texte d’embarquement couvre SKILL.md plus environ quarante fichiers UTF-8 bornés, au mieux.

Cette seconde limite est celle qui surprend, car elle ne veut pas dire que le reste du paquet est ignoré. Les analyseurs reçoivent l’artefact stocké complet dans tous les cas ; ce que le plafond borne, c’est la couche d’analyse textuelle et d’aperçu. Les fichiers bornés et en UTF-8 valide peuvent être prévisualisés en texte brut échappé, et tout le reste garde ses octets exacts et reste téléchargeable. Pour le chemin de publication que ces fichiers empruntent, voir Ce que ClawHub vérifie avant publication et Démarrage rapide ClawHub.

L’importateur est plus strict que le CLI

Publier depuis l’importateur GitHub web n’est pas la même chose que publier localement, et la différence prend les gens au dépourvu. L’importateur ne découvre les fichiers de compétence que dans des dépôts publics, non forkés, appartenant au compte GitHub connecté. Les dépôts privés, les forks, les dépôts archivés ou désactivés et les dépôts publics de tiers sont tous hors de sa portée, alors que la publication et la synchronisation locales n’ont pas cette restriction. Si un import ne trouve rien en silence, cette liste est la première chose à vérifier. Voir Le CLI ClawHub pour le chemin local et Comment fonctionne ClawHub pour ce que le registre fait du résultat.

Sur Diali

Diali héberge OpenClaw, donc une compétence que vous publiez s’installe dans un assistant qui tourne déjà. Chaque client fait tourner le sien, la configuration d’exécution est générée depuis le tableau de bord et remplacée à chaque version, et l’état vit sur un volume persistant, avec des instantanés quotidiens et une restauration en un clic grâce à l’option Sauvegardes (incluse avec Max). Voir OpenClaw hébergé sur Diali pour ce que l’hébergement comprend et Tarifs Diali pour ce qu’il coûte.

• Un seul fichier obligatoire, et l’en-tête fait le reste.
• Écrivez la description pour le lecteur qui décide d’installer, pas pour vous-même.
• L’importateur ne voit que les dépôts publics, non forkés, de votre propre compte.