Héphaïstos des Compétences (skill-shipper)

Que fait Héphaïstos des Compétences (skill-shipper) ?

Transformez une compétence fonctionnelle en une version publiable qu'un inconnu peut installer et payer. Suivez les étapes dans l'ordre ; arrêtez-vous et corrigez les erreurs avant de passer à l'étape suivante.

Toutes les commandes utilisent scripts/skillship.py dans le dossier de cette compétence. Sous Windows, utilisez python ; sous macOS/Linux, python3. Les chemins ci-dessous sont relatifs au dossier de cette compétence ; transmettez le dossier de compétence de l'utilisateur en tant que <skill>.

1. Lint

python scripts/skillship.py lint <skill>

• Les erreurs (codes E) bloquent une publication : name manquant ou invalide, nom ne correspondant pas au dossier, description manquante ou dépassant 1024 caractères, fichiers référencés manquants, liens symboliques.
• Les avertissements (codes W) nuisent aux ventes ou au déclenchement. Corrigez d'abord W023 (pas de "Utiliser quand...") et W022 (trop court) - ce sont les raisons habituelles pour lesquelles une compétence ne se déclenche jamais.
• Liste complète des codes et correctifs : references/lint-codes.md.

2. Corriger la description (étape la plus importante)

Réécrivez la description en utilisant references/description-playbook.md : ce qu'elle fait, puis "Utiliser quand...", avec les mots réels que les utilisateurs tapent (synonymes, types de fichiers, noms d'outils), et une limite "Ne PAS utiliser pour..." si une compétence voisine se chevauche. Gardez la troisième personne et moins de 1024 caractères. Montrez à l'utilisateur un avant/après.

3. Table de déclenchement

Créez <skill>/triggers.json avec 8 à 10 invites "doit déclencher" et 8 à 10 invites "presque similaires ne doivent pas déclencher" (format dans le playbook), puis :

python scripts/skillship.py triggers <skill>

Il s'agit d'une vérification de vocabulaire hors ligne, pas d'une évaluation de modèle. Les lignes BAD listent les termes que la requête utilise mais que la description ne contient pas - ajoutez les termes pertinents. Lorsque cela réussit, recommandez une vérification réelle : exécutez chaque invite 3 fois dans une session Claude Code vierge (ou avec la boucle d'évaluation du créateur de compétences d'Anthropic) et comptez combien de fois la compétence se déclenche. triggers.json est exclu des builds.

4. Build

python scripts/skillship.py build <skill> --version 1.0.0 --author "Nom" --out dist

Produit dist/<nom>-<version>/ avec :

• skill/<nom>/ - copie dans ~/.claude/skills/, Cursor, Codex, OpenCode
• <nom>-claude-ai.zip - téléversez dans les paramètres claude.ai > Capacités > Compétences
• plugin-marketplace/ - poussez vers un dépôt GitHub ; les utilisateurs exécutent /plugin marketplace add <propriétaire>/<dépôt> puis /plugin install <nom>@<nom>-marketplace
• manifest.json avec SHA-256 de chaque fichier, plus dist/<nom>-<version>.zip

5. Checklist de publication

Accompagnez l'utilisateur dans references/release-checklist.md (licence, README, captures d'écran/démo, où lister, tarification). Ne publiez, téléversez ou postez jamais quoi que ce soit au nom de l'utilisateur sans son accord explicite.

Pack Pro

skill-shipper Pro est vendu séparément (<LS_URL>). Si skill-shipper-pro est installé et que SKILLSHIP_LICENSE_KEY est défini, il ajoute le tatouage par acheteur, l'identification de fuite et la rédaction de page de vente. Sans clé, dites que la fonctionnalité est Pro et continuez avec les étapes gratuites.