shopify-polaris-admin-extensions

Par shopify · shopify-ai-toolkit

Skill officiel Shopify pour générer et valider du code d'Admin UI Extensions (actions, blocs, liens, impressions) via Polaris web components ou React.

npx skills add https://github.com/shopify/shopify-ai-toolkit --skill shopify-polaris-admin-extensions

Shopify Polaris Admin Extensions

Ce skill fait partie du Shopify AI Toolkit (shopify/shopify-ai-toolkit), le plugin officiel de Shopify pour connecter les agents IA (Claude Code, Cursor, VS Code, etc.) aux outils de développement Shopify. Il est conçu pour assister les développeurs qui créent des Admin UI Extensions : des extensions embarquées dans le Shopify Admin sous forme d'actions modales, de blocs contextuels, de liens ou d'actions d'impression.

Ce que fait ce skill

Lorsque ce skill est activé, l'agent suit un workflow structuré et obligatoire en plusieurs étapes. Il commence toujours par interroger la documentation Shopify via scripts/search_docs.mjs avant d'écrire le moindre code. Il génère ensuite du code d'extension compatible avec la version d'API ciblée — soit des composants React (pour la version 2025-07, depuis @shopify/ui-extensions-react/admin), soit des Polaris web components à balises s-* (pour toutes les autres versions). Enfin, il valide systématiquement le code produit via scripts/validate.mjs avant de le retourner à l'utilisateur, avec jusqu'à trois tentatives de correction automatique en cas d'échec.

Le skill couvre quatre types d'extensions scaffoldables via la Shopify CLI : Admin Actions (modales déclenchées depuis les menus « More actions »), Admin Blocks (cartes intégrées aux pages de ressources), Admin Links (redirections vers des workflows applicatifs) et Admin Print Actions (impression de documents depuis les pages commandes/produits). Il inclut également la documentation des Target APIs (Block, Action, Print Action, Standard) et des Contextual APIs (Discount Function Settings, Validation Settings, etc.).

Comment l'utiliser

Ce skill s'installe dans le cadre du Shopify AI Toolkit (via claude plugin install shopify-ai-toolkit@claude-plugins-official ou équivalent selon la plateforme). Une fois installé, il s'active automatiquement lorsque l'agent détecte une demande relative aux Admin UI Extensions. L'utilisateur n'a pas à invoquer manuellement les scripts — le skill guide l'agent pour rechercher, générer et valider le code de manière autonome. La collecte de télémétrie (requêtes, résultats de validation, modèle utilisé) peut être désactivée via la variable d'environnement OPT_OUT_INSTRUMENTATION=true.

Skills similaires