Skills

Création de compétences personnalisées

Enveloppez vos propres flux de travail afin que tout agent connecté à Showly puisse les utiliser.

La compétence officielle Showly couvre la boucle de publication canonique. Les équipes disposent souvent de flux de travail _supplémentaires_ spécifiques à leur pile : contrôle qualité de la marque, contrôles de conformité du contenu, localisation automatisée. Vous pouvez les envoyer en tant que compétences personnalisées que tout agent connecté à Showly récupérera.

Quand écrire une compétence ou juste un script

Écrivez une compétence lorsque :

Le workflow est _intent-triggered_ (l'utilisateur dit « déployer » ou « traduire » et l'agent doit le savoir).
Le workflow comporte des modèles de refus/sécurité qui méritent d'être codés (ne pas expédier sans contrôle, ne pas publier pendant le gel).
Il est réutilisable entre les membres de l'équipe ou les projets.

Écrivez simplement un script lorsque :

Le workflow s'exécute dans CI, pas dans une conversation d'agent.
C'est une pièce unique que tu jetteras.

Anatomie d'une compétence consciente du Showly

Une compétence est un manifeste et des invites. Le minimum :

name: my-publish-with-localize
description: |
  Use when the user wants to publish a Showly site that has
  user-facing strings. This skill localizes new/changed strings,
  runs `run_checks`, then proposes a publish.
trigger:
  intents:
    - "publish"
    - "ship"
    - "release"
mcp:
  required:
    - showly
    - localizer
prompt: |
  1. Call mcp__showly__get_site_context to read the change.
  2. Identify new/changed strings in any *.tsx files.
  3. Call mcp__localizer__translate for each new string.
  4. Apply translations via mcp__showly__apply_site_patch.
  5. Call mcp__showly__create_preview.
  6. Call mcp__showly__run_checks (include `i18n-coverage`).
  7. If checks pass, call mcp__showly__request_publish.
  8. Refuse to call request_publish if any check failed.

Référence du champ

Champ	Tapez	Obligatoire	Remarques
`name`	chaîne	oui	L'identifiant de la compétence. Stable dans toutes les versions ; le renommer est un changement radical.
`description`	chaîne	oui	Quand l’agent doit utiliser cette compétence. Écrit pour l'agent, pas pour l'utilisateur final : décrivez la situation de déclenchement.
`trigger.intents`	tableau de chaînes	non	Phrases qui font ressortir la compétence (par exemple `"publish"`, `"ship"`). En cas d'omission, l'agent s'appuie uniquement sur `description` pour décider quand l'invoquer.
`mcp.required`	tableau de chaînes	non	MCP serveurs qui doivent être connectés pour que la Skill puisse fonctionner (par exemple `showly` plus l'un des vôtres).
`prompt`	chaîne	oui	Les instructions que l'agent suit, écrites sous forme d'étapes numérotées.

Les étapes prompt ne sont pas exécutées par Showly — ce sont des instructions transmises à l'agent. L'agent les lit dans l'ordre et appelle lui-même les outils nommés MCP (par exemple mcp__showly__get_site_context, puis mcp__showly__apply_site_patch), en appliquant les contrôles de refus que vous encodez. Utilisez les identifiants d'outils exacts de la MCP référence de l'outil pour que l'agent appelle de vrais outils. Le chemin de production vers un site en ligne est toujours request_publish, ce qui renvoie un webApprovalUrl pour qu'un humain termine la publication — la Skill ne peut pas publier seule en production.

Pour le schéma complet du manifeste (le manifest.json tapé dans la compétence officielle est livré), voir Installer la compétence.

Modèles de refus

La partie la plus difficile d'une compétence utile est d'encoder _ce qu'il ne faut pas faire_. Exemples de la compétence officielle Showly :

Pas de publication sans aperçu récent : si create_preview n'a pas été appelé dans cette conversation, refusez request_publish.
Pas de publication pendant le gel : si la politique de l'espace de travail indique "fusion gel actif", refusez et liez l'annonce de gel.
Pas de publication en cas de bris de glace : MCP n'a pas de contournement d'urgence. Si l'utilisateur indique que le correctif est urgent, créez toujours un aperçu, exécutez des vérifications et demandez l'approbation.

Codez-les dans votre invite sous forme de puces que l'agent doit vérifier avant chaque appel d'outil.

Distribution

Trois options :

Personnel — déposez la compétence dans ~/.claude/skills/. Vous seul le voyez.
Workspace — validez-le dans votre dépôt de site Showly sous .showly/skills/. Toute personne ayant accès à l’espace de travail l’installe automatiquement.
Public — publiez votre Skill en tant que son propre package et laissez les autres l'installer de la même manière que le client officiel Showly est installé : npx @showly/mcp-server install --to <claude-code|codex|stdout>. Il s'agit de la commande d'installation canonique : suivez la même forme afin que les auteurs et les installateurs restent sur le même chemin.

Les chemins d'installation ci-dessus correspondent à Installer la compétence : la commande canonique est npx @showly/mcp-server install (le package @showly/mcp-server, bin showly-mcp). Utilisez la même forme pour votre compétence personnalisée afin que les auteurs et les installateurs suivent le même chemin.

Gestion des versions

Les compétences suivent sever. Les changements radicaux (renommer les intentions, supprimer les étapes de l'outil) apportent une nouvelle majeure. Exécutez showly-mcp (le bac expédié par @showly/mcp-server) pour installer et mettre à jour ; la réexécution de npx @showly/mcp-server install récupère la dernière version.

Où lire ensuite

MCP référence de l'outil — ce que fait chaque outil et comment les enchaîner.

\-Modèle de compétences — pourquoi les compétences existent et en quoi elles diffèrent des outils bruts.