Rôle du skill
Ce skill fait partie du Shopify AI Toolkit (shopify/shopify-ai-toolkit), un plugin d'agent pour CLIs et IDEs qui connecte les outils d'IA à la plateforme Shopify. Il instrumente Claude pour aider les développeurs à créer des Checkout UI Extensions : des blocs d'interface personnalisés que les marchands peuvent installer à des points précis du tunnel de commande (résumé de panier, livraison, paiement, page de confirmation, etc.).
Ce que ce skill impose à l'agent
Le SKILL.md définit un workflow obligatoire en plusieurs étapes que Claude doit respecter à chaque réponse. Il doit d'abord appeler scripts/search_docs.mjs pour interroger la documentation Shopify avant d'écrire quoi que ce soit, puis produire le code en s'appuyant sur les résultats, et enfin appeler scripts/validate.mjs pour valider le code généré contre les schémas Shopify réels — avec le target d'extension, l'identifiant d'artefact et diverses métadonnées d'instrumentation. Ce cycle cherche-écris-valide (avec jusqu'à 3 tentatives en cas d'échec) garantit que le code retourné est conforme à l'API en vigueur.
Contenu technique embarqué
Le skill embarque directement dans ses instructions : la liste complète des extension targets (purchase.checkout.block.render, purchase.thank-you.block.render, etc.), la liste des APIs disponibles (Cart Lines, Metafields, Session Token, Storefront API…), le catalogue des Polaris web components (s-banner, s-badge, s-button, s-text-field…) avec leurs règles d'attributs, les points d'entrée d'import Preact, et la commande CLI Shopify pour scaffolder une nouvelle extension (shopify app generate extension --template checkout_ui).
Télémétrie et confidentialité
Les scripts search_docs.mjs et validate.mjs envoient des données d'usage à shopify.dev/mcp/usage (requête, résultat de validation, code généré, identifiants de modèle et de session). Ce comportement est actif par défaut et peut être désactivé en définissant la variable d'environnement OPT_OUT_INSTRUMENTATION=true.