jiweibo/skillshare

CLI Skillshare

Utilisez Skillshare pour maintenir une source et distribuer des ressources vers des cibles configurées. Lisez uniquement la référence pertinente pour l'opération demandée ; la table de routage se trouve ci-dessous. Consultez skillshare <commande> --help si la version installée diffère de ces exemples.

Portée et sélection des ressources

• Configuration globale : ~/.config/skillshare/config.yaml. Configuration de projet : .skillshare/config.yaml ou skillshare/config.yaml ; le fichier caché l'emporte lorsque les deux existent. Utilisez -g ou -p explicitement lorsque l'emplacement importe plutôt que de compter sur la détection automatique.
• Les compétences sont des répertoires contenant SKILL.md ; les agents sont des fichiers Markdown uniques. Les chemins source peuvent être personnalisés. Utilisez les sources configurées au lieu de supposer les valeurs par défaut.
• Les copies suivies skills/<agent-connu>/<chemin-compétence>/SKILL.md forment une compétence logique par dépôt/préfixe/suffixe. La fusion/la copie sélectionne la variante d'agent exacte (incluant les alias et l'identité agent: du compte). La reconnaissance nécessite le même suffixe sous deux agents canoniques distincts. Les cibles compatibles partageant un dossier sélectionnent l'union de leurs identités d'agents ; une cible universelle uniquement n'infère pas d'agent. Le statut compte les compétences logiques et les variantes physiques ; les opérations de liste et de synchronisation conservent les noms physiques. Les cibles/remplacements explicites et les filtres physiques s'appliquent toujours. Le mode lien symbolique vers un répertoire entier expose toutes les variantes. Voir sync.md.
• Utilisez les cibles d'agents natifs pour les agents. Utilisez les extras pour les ressources fichier arbitraires ou lorsque l'aplatissement/la transformation de contenu est nécessaire ; extension: ne fonctionne que sur les cibles extras.
• Les notes de mémoire partagées se trouvent dans l'extra memory. Utilisez extras memory pour gérer les notes Markdown et les directives de lecture ; les chemins imbriqués tels que wiki/architecture.md sont pris en charge. Lisez extras.md pour la portée, les vérifications de version et la configuration de l'agent. Pour une rétrospective de session ou le Rêve (Dreaming) sur les notes enregistrées, lisez memory-review.md. L'agent hôte effectue la revue ; Skillshare ne lance ni ne planifie jamais d'agent.
• MCP utilise ses propres cibles de réception et définitions de source. Lisez mcp.md avant de modifier les paramètres MCP ou d'importer des configurations natives. Ses notes sur les agents couvrent ce qui est spécifique à Claude Code, Codex, OpenCode et Pi : portées et fichiers, noms et identifiants qu'ils refusent, le MCP intégré de Pi et piOptions, le MCP natif d'OMP et ses listes d'activation/désactivation préservées, la politique tools portable, la mise à jour des paramètres Pi depuis la version 0.22, la désactivation d'un serveur global dans un seul projet, mcp.projects pour plusieurs dossiers à partir d'une seule configuration, et mcp serve pour les Agents qui ne peuvent pas atteindre les dossiers de compétences synchronisées.
• Les plugins maintiennent leurs composants natifs ensemble. Lisez plugins.md pour l'installation, l'importation, la sélection de synchronisation, les mises à jour et les limites de compatibilité native avec Claude, Codex, Cursor, Antigravity, Pi, OMP et OpenCode, y compris les paquets Pi de pi.dev et les plugins de la place de marché OMP et la sélection d'extensions autonomes.
• Les hooks préservent la carte d'événements native de chaque Agent ou le code d'extension/plugin. Lisez hooks.md avant l'importation, la synchronisation ou la récupération.

Règles d'exécution

1. Choisissez des entrées non interactives. Fournissez les noms et les indicateurs de sélection pris en charge par la commande spécifique. Utilisez --no-tui pour une sortie simple ou --json lorsque c'est pris en charge. N'ajoutez pas --force simplement pour éviter une invite : cela peut écraser des conflits ou passer outre des audits.
2. Séparez les aperçus des écritures. Utilisez --dry-run lorsque c'est pris en charge. Après avoir modifié des compétences ou des agents, synchronisez la ressource et la portée prévues. Les mutations MCP et des hooks sauvegardent la source uniquement sauf si --sync est fourni ; sync --all inclut également les extras, MCP et hooks, mais exclut les plugins.
3. Inspectez les blocs d'audit. Examinez les résultats avant de choisir un remplacement. install --json permet l'écrasement et sélectionne tout lorsqu'aucun filtre de compétence/agent n'est donné, mais conserve la porte d'audit ; ce n'est pas simplement un format de sortie. Lisez install.md et audit.md avant de l'utiliser pour l'automatisation.
4. Utilisez le mécanisme de récupération approprié. Les compétences désinstallées vont à la corbeille ; les entrées MCP natives utilisent les sauvegardes MCP. Ne remplacez pas la suppression du système de fichiers par la désinstallation CLI.
5. Gardez les identifiants hors des définitions MCP. Utilisez les références {fromEnv: VARIABLE}. La gestion des paramètres ne nécessite pas de résoudre des secrets, copier des identifiants OAuth, démarrer des serveurs ou sonder leurs outils.
6. Respectez la portée de l'opération. Le travail de configuration locale n'implique pas la permission de commit, push ou publier. Exécutez ces commandes lorsqu'elles sont incluses dans la demande de l'utilisateur.

Workflows courants

Inspecter et diagnostiquer

skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json

doctor se termine par le code 1 lorsqu'il trouve des erreurs. L'audit utilise --format json ; les indicateurs JSON et la disponibilité de l'interface utilisateur TUI varient selon la commande. Consultez la référence pertinente plutôt que de supposer une parité.

Suivre un dépôt amont ou installer des compétences sélectionnées

Choisissez la ressource et la portée avant d'installer. Utilisez -g pour les ressources à l'échelle de l'utilisateur ou -p pour ce projet ; conservez cette portée sur l'aperçu, l'application, la mise à jour et la synchronisation.

Intention	Commande
Garder une collection de compétences amont comme un seul checkout Git	skillshare install owner/repo --track --name team -g
Installer uniquement les compétences nommées avec leurs métadonnées de source	skillshare install owner/repo -s pdf,commit -g
Installer toutes les compétences découvertes individuellement	skillshare install owner/repo --all -g
Gérer un plugin natif complet, y compris les hooks/MCP	Utilisez plugin discover et plugin add ; voir ci-dessous

Pour le workflow aperçu → appliquer → mettre à jour → synchroniser avec portée, lisez install.md. Il couvre le suivi de la dernière branche amont, les combinaisons d'indicateurs rejetées et les filtres de cible.

Pour la configuration de projet, utilisez init -p, puis install -p et sync -p. Réhydratez les dépendances distantes configurées avec install sans source. Pour les détails complets des indicateurs et des agents, lisez install.md et sync.md.

Pour utiliser un checkout local de compétences en place, exécutez skillshare link <chemin> --enable, puis sync ; skillshare unlink <nom> supprime uniquement le lien. Lisez TROUBLESHOOTING.md pour savoir comment ces liens sont suivis.

Désactiver ou supprimer

skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync

Exécutez l'opération demandée, pas cette séquence d'exemple entière. Entourez les motifs glob de guillemets pour que Skillshare les reçoive inchangés. La désactivation utilise des règles d'ignore ; la désinstallation utilise la corbeille.

Déplacer des compétences dans des dossiers

skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync

Utilisez move au lieu de mv pour les compétences installées : cela conserve leurs enregistrements d'installation, donc rien n'est téléchargé à nouveau. Cela ne synchronise pas ; exécutez sync ensuite. Lisez install.md pour les refus et le mode projet.

Dossiers de projet à partir de la configuration globale

skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json

project utilise toujours la configuration globale, même à l'intérieur d'un dépôt ; il n'accepte pas -p. Les nouveaux projets sont enregistrés dans config.yaml, ou sur cette machine uniquement avec --machine-local ou projects_storage: machine-local (--shared remplace le paramètre) ; localize et share en déplacent un entre les deux. La suppression d'une copie locale d'un projet config.yaml garde la version de config.yaml sauf si --shared est donné. Les filtres d'édition remplacent les listes. La suppression détache les compétences et conserve les fichiers d'agent ; la suppression JSON nécessite --yes sauf en mode aperçu. Lisez targets.md pour les échecs d'enregistrement-puis-synchronisation, les tentatives et les résultats de suppression partielle.

Paramètres MCP

skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp

--target est singulier et répétable. Un aperçu n'applique pas les modifications. Pour les révisions, l'édition, les conflits d'importation, les identifiants, les sauvegardes et les commandes TUI opérées par un humain, lisez mcp.md.

Plugins complets

Utilisez plugin discover et plugin add pour un paquet natif complet ; plugin import adopte une installation native existante. Exécutez uniquement l'opération demandée. Lisez plugins.md avant d'appliquer des modifications ; il couvre le workflow amont avec portée, les cibles prises en charge et les règles de référence source. plugin check/update gère les modifications amont ; sync plugins réconcilie la sélection de cible. Les plugins sont exclus de sync --all.

Hubs de compétences

skillshare hub add https://example.com/hub.json          # Enregistrer une source de hub
skillshare hub add https://example.com/hub.json --label my-hub  # Avec un libellé personnalisé
skillshare hub add [email protected]:team/skills.git --label ghe  # Source de hub SSH/privée/GHE
skillshare hub list                                      # Lister les hubs enregistrés
skillshare hub default my-hub                            # Définir le hub par défaut
skillshare hub remove my-hub                             # Supprimer un hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Construire un index de hub

Le paramètre actif follow_source_links s'applique également à hub index (y compris --source), à la recherche intégrée du tableau de bord et aux candidats brouillons du Hub.

Références

Lisez le fichier correspondant pour les indicateurs de commande, les exemples et les limitations. Évitez de charger toutes les références pour une seule tâche.

Sujet	Fichier
Agents natifs, sélection, règles d'ignore et récupération	native-agents.md
Configuration MCP, importations, TUI et récupération	mcp.md
Hooks natifs, liaisons de code, portées et récupération	hooks.md
Plugins complets, cycle de vie natif et sélection de synchronisation	plugins.md
Indicateurs d'init	init.md
Sync/collect/commit/push/pull	sync.md
Install/update/uninstall/move/new	install.md
Status/diff/list/search/check	status.md
Audit de sécurité	audit.md
Vérifier une compétence non fiable avant l'installation	audit-review.md
Corbeille	trash.md
Journal des opérations	log.md
Cibles	targets.md
Extras (règles/commandes/invites)	extras.md
Rétrospectives de session et Rêve (Dreaming) sur les notes enregistrées	memory-review.md
Sauvegarde/restauration	backup.md
Dépannage	TROUBLESHOOTING.md