Le CLI hubskillz

Installation

Node 22 requis. Installez-le une fois pour toutes, ou lancez chaque commande avec npx.

npm i -g hubskillz
npx hubskillz <command>
hubskillz help [command]

Connexion

Créez un token machine dans l’app, rubrique Paramètres puis Tokens machine, et collez-le quand le CLI le demande. Tokens machine

hubskillz login [--token TOKEN] [--base-url URL]
hubskillz logout

Instance auto-hébergée ? Passez --base-url ou définissez HUBSKILLZ_BASE_URL. Le CLI stocke sa config dans ~/.hubskillz/config.json.

En CI ou dans un conteneur, définissez HUBSKILLZ_TOKEN au lieu de vous connecter : aucun fichier n’est écrit. hubskillz logout supprime le jeton stocké.

Voir l’état

hubskillz status [--path DIR] [--yes]

Scanne les skills du projet courant (ou de --path DIR), sinon le dossier global ~/.claude/skills, envoie l’inventaire et affiche une ligne par skill avec son état, le hash installé et la version validée. N’écrit rien.

Appliquer les versions validées

hubskillz sync [--path DIR] [--all] [--adopt] [--yes] [--dry-run] [--force]

Affiche le plan, puis installe ou met à jour chaque skill que vos équipes exigent ou recommandent, une fois que vous avez confirmé. --all couvre le dossier global et le projet. --dry-run s’arrête au plan, --yes saute la confirmation, --force écrase aussi les skills que vous avez modifiés.

--adopt ajoute au répertoire, en version validée et sans poser de question, chaque skill présent sur cette machine que le répertoire ne connaît pas encore. Sans l’option, sync vous pose la question une fois. Les skills venus de skills.sh sont figés à la version installée. Les skills privés sont créés à partir de la copie envoyée par le CLI avec l’inventaire. Réservé aux mainteneurs.

Envoyer un brouillon

hubskillz push <skill-dir> [-m MESSAGE]

Envoie les fichiers d’un dossier de skill au catalogue comme nouvelle version en brouillon, avec un message facultatif. Un mainteneur prend le relais pour la review.

Enregistrer vos dépôts

hubskillz projects [add|remove [DIR] | discover [--yes] | list]

Mémorise le dossier courant (ou DIR) pour que sync --all et status le couvrent depuis n’importe où, avec la racine globale. discover parcourt votre dossier personnel à la recherche de dépôts avec .claude/skills et vous laisse choisir lesquels enregistrer (--yes les prend tous). Le premier sync --all ou status sans dépôt enregistré lance ce parcours pour vous. Un chemin enregistré sans .claude/skills est ignoré avec une note.

États