Communitygithub.com

xFurti/skillctl

Gestionnaire de paquets universel en ligne de commande pour les compétences d'agents — manifeste, fichier de verrouillage, synchronisation multi-agents (Cursor, Claude, Codex, Gemini). Nécessite Node ≥22.13.

Qu'est-ce que skillctl ?

skillctl est un outil CLI conçu pour gérer les compétences (skills) des agents d'IA de manière centralisée et portable. Il permet d'installer, synchroniser et auditer les compétences entre plusieurs plateformes comme Cursor, Claude, Codex et Gemini, en utilisant un manifeste (agent-skills.json) et un fichier de verrouillage (agent-skills.lock) pour garantir la reproductibilité en équipe. L'outil offre des commandes pour initialiser un projet, ajouter des compétences depuis des sources locales ou distantes (GitHub, npm, fichiers locaux), importer des compétences existantes, et exécuter des audits en CI. Il repose sur un magasin canonique unique (~/.skillctl/skills/), évite les chemins absolus non portables, et prend en charge les modes de déploiement par lien symbolique ou copie selon le système d'exploitation. idéeal pour les développeurs qui souhaitent standardiser et automatiser le cycle de vie des compétences agent.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add xFurti/skillctl

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait skillctl ?

Manuel opérationnel pour gérer les compétences d'agents avec l'interface en ligne de commande skillctl. Exécutez de vraies commandes ; ne simulez pas la sortie et ne copiez pas manuellement les fichiers SKILL.md entre les répertoires d'agents.

Règles d'or

  1. Un seul dépôt canonique — les compétences résident dans ~/.skillctl/skills/<nom>/ ; les agents reçoivent des liens symboliques via sync.
  2. Versionnez le manifeste + le verrou — suivez agent-skills.json et agent-skills.lock dans git pour la reproductibilité en équipe.
  3. Spécificateurs portables uniquement — utilisez file:./<chemin>, local:importé/<nom>, github:, npm:, ou skills.sh/ ; ne validez jamais de chemins absolus vers le répertoire personnel.
  4. Installez avant de synchroniser — install matérialise le dépôt ; sync ne fait que re-lier les agents.
  5. Vérifiez après les modifications — exécutez skillctl doctor (et skillctl audit en CI).
  6. Privilégiez l'importation à la copie manuelle — utilisez import from-project ou import from-npx au lieu de dupliquer les dossiers de compétences.

Arbre de décision

SituationCommande
Nouveau projet, pas de manifesteskillctl init ou skillctl init --with-skill
Ajouter une compétence distante ou localeskillctl add <spécificateur> puis skillctl install
Compétences déjà dans .claude/skills, .codex/skills, etc.skillctl import from-project
Migration depuis npx skillsskillctl import from-npx
Re-lier uniquement (verrou inchangé)skillctl sync
Re-télécharger depuis la sourceskillctl update ou skillctl update <nom>
Installation reproductible en CIskillctl install --frozen puis skillctl audit --strict
Chemins non portables dans le verrouskillctl install pour réécrire ; vérifiez les avertissements de skillctl doctor

Recettes rapides

# Amorcer
skillctl init --with-skill
skillctl add github:vercel-labs/agent-skills#web-design-guidelines
skillctl install

# Compétence locale au projet
skillctl add file:./ma-competence
skillctl install
skillctl sync

# Importer des répertoires agents existants
skillctl import from-project --dry-run
skillctl import from-project

# Inspecter
skillctl list
skillctl doctor
skillctl audit --json

Attendu après add file:./ma-competence + install : spécificateur du manifeste file:./ma-competence, canonicalPath du verrou comme ~/.skillctl/skills/ma-competence.

Portabilité (0.3.1+)

  • Portable : file:./rel, local:importé/<nom>, spécificateurs distants, canonicalPath: ~/.skillctl/skills/<nom>.
  • Non portable : file:/Users/... absolu, local:/chemin/absolu absolu, canonicalPath absolu d'une autre machine.
  • Si doctor émet des avertissements concernant des chemins non portables, exécutez skillctl install pour réécrire le verrou à partir du manifeste.

Modes de défaillance

SymptômeAction
canonical path missingskillctl install
Incohérence d'intégritéskillctl update <nom> ou skillctl install
Échec du lien symbolique (Windows)doctor le signale ; configurer defaultMode: copy
Aucun agent liéskillctl sync ; activer les agents dans ~/.skillctl/config.json
Frozen install failedDépôt désynchronisé ; exécuter install sans --frozen

Références

Skills associés