Skills

Showly Compétences

Compétences comme interface visible par l'utilisateur pour les capacités de l'agent.

Showly publie une Claude Code Skill officielle qui enveloppe le serveur MCP avec des invites orientées tâches. La Skill est le moyen le plus simple d'utiliser Showly à partir d'un agent : vous l'installez, l'agent sait automatiquement quand appeler les outils Showly et les invites codent déjà les conventions de boucle de publication.

Pourquoi les compétences

Un serveur brut MCP donne des outils à un agent. Une compétence apprend à l'agent _quand_ et _pourquoi_ à les utiliser. La compétence Showly comprend :

  • Une description qui se déclenche sur intention ("déployer", "publier", "aperçu", "showly").
  • Scripts internes qui enchaînent create_change_plan → apply_site_patch → create_preview → run_checks → request_publish pour que l'agent n'ait pas à le faire.
  • Étapes de vérification qui lisent l'URL d'aperçu et font rapport.
  • Modèles de refus pour les actions que l'agent ne devrait pas entreprendre seul (les publications de production sont toujours transmises à un humain via la porte d'approbation).

Installation de la compétence officielle

En Claude Code (ou Codex) :

npx @showly/mcp-server install --to claude-code   # or --to codex

Ceci s'installe à partir du package @showly/mcp-server et enregistre le serveur Showly MCP pour vous. Il n'y a aucun jeton à définir : la première fois que vous appelez un outil Showly, votre agent ouvre un onglet de navigateur pour se connecter et approuver l'accès, et Showly émet un jeton étendu directement à l'agent (standard MCP OAuth). Voir Installation de Skill pour la poignée de main complète et la solution de secours sans navigateur.

Que fait la compétence que le MCP brut ne fait pas

  • Découvre automatiquement le site actif à partir du répertoire de travail actuel en faisant correspondre la télécommande GitHub du référentiel avec les sites de votre espace de travail Showly.
  • Rend les aperçus en ligne avec des captures d'écran de mcp__playwright_browser_take_screenshot si Playwright MCP est également installé.
  • Refuse de demander une publication sans un aperçu récent ; la production publie toujours par request_publish et une approbation humaine.

Découverte automatique

Lorsque vous exécutez un agent dans un dépôt extrait, la compétence lit le code distant origin du dépôt et recherche un site dans votre espace de travail dont repositoryUrl correspond. Le siteId du site correspondant devient la cible pour get_site_context, apply_site_patch, create_preview et le reste de la boucle, vous devez donc rarement nommer un site à la main.

Si aucun site ne correspond à la télécommande, la compétence vous demande d'en choisir ou d'en créer un plutôt que de deviner. Si plusieurs sites partagent la télécommande, il vous demande de lever l'ambiguïté.

Publier des garde-corps

La production n'est jamais publiée directement par un agent. Avant de demander une publication, la Skill vérifie que :

  • Il existe un récent déploiement d'aperçu ready pour le site.

- run_checks est passé par rapport à cet aperçu.

Lorsque ceux-ci sont valables, la compétence appelle request_publish, qui renvoie un lien profond webApprovalUrl. Un humain disposant de droits d'administrateur approuve la demande dans l'interface utilisateur Web ; l'agent interroge uniquement l'état d'approbation. Il n’existe pas de parcours d’agent menant à la production sans cette étape humaine.

Suivant