Rôle du skill shopify-polaris-app-home
Ce skill fait partie du Shopify AI Toolkit (shopify/shopify-ai-toolkit), un plugin agent pour CLIs et IDEs (Claude Code, Cursor, VS Code, etc.) qui connecte les outils d'IA à la plateforme Shopify. Son rôle est d'instruire Claude sur la façon de générer du code d'interface utilisateur pour les App Home extensions Shopify, c'est-à-dire les interfaces embarquées dans l'admin Shopify et construites avec le framework Polaris App Home.
Contrairement à un squelette vide, ce SKILL.md contient un ensemble complet d'instructions opérationnelles. Il définit un workflow strict que Claude doit suivre à chaque réponse : rechercher la documentation via scripts/search_docs.mjs, écrire le code en s'appuyant sur les résultats, puis le valider obligatoirement via scripts/validate.mjs avant de le retourner à l'utilisateur. Ce cycle recherche → code → validation est central au skill.
Ce que couvre le skill
Le skill documente les APIs App Bridge disponibles (Navigation, Modal, Toast, Save Bar, etc.), le hook React useAppBridge, ainsi qu'une bibliothèque de composants web Polaris à préfixe s- (s-page, s-badge, s-button, s-table, etc.) utilisables directement en JSX sans import. Il précise également les patterns de composition (index table, setup guide, metrics card…) et les templates (Homepage, Details, Settings) disponibles pour les cas d'usage courants.
Le skill définit aussi des règles précises sur les imports autorisés (@shopify/app-bridge-react, @shopify/app-bridge-types, @shopify/polaris-types) et interdit explicitement l'usage de packages inexistants comme @shopify/polaris ou @shopify/polaris-react dans ce contexte.
Utilisation dans votre environnement
Ce skill s'active automatiquement lorsque vous posez une question sur Polaris ou la construction d'une interface App Home dans un éditeur compatible (Claude Code, Cursor, VS Code avec le plugin Shopify installé). Si votre contexte mentionne simplement « Polaris » sans préciser quelle API, le skill suppose qu'il s'agit de Polaris App Home. Pour l'installer manuellement, référez-vous au README du repo parent ou à la documentation officielle sur shopify.dev/docs/apps/build/ai-toolkit.