Créer un Custom Skill Claude Code pour Shopify

À retenir

• Un skill Claude Code est un dossier contenant un fichier SKILL.md. Le frontmatter indique à Claude quand l’utiliser. Le corps du fichier lui dit quoi faire.¹
• Les skills personnels vivent dans ~/.claude/skills/<nom>/SKILL.md. Les skills de projet vivent dans .claude/skills/<nom>/SKILL.md et peuvent être commités sur git.¹
• Créez un skill si vous passez votre temps à copier-coller la même checklist Shopify dans le chat. Installez le plugin Shopify AI Toolkit quand vous avez besoin de la doc, de la validation de schema, et de l’exécution sur la boutique.²
• Claude charge un skill automatiquement quand votre demande correspond à sa description, ou vous pouvez l’invoquer directement via /nom-du-skill.¹
• Gardez SKILL.md sous la barre des 500 lignes. Déplacez les longues documentations de référence dans des fichiers séparés.¹

Ce tutoriel sur les skills shopify pour claude code vous montre comment créer votre propre skill d’agent pour vos tâches Shopify : un fichier SKILL.md réutilisable qui génère la structure (scaffold) d’une section Liquid, la valide selon les règles de votre équipe, et ne se charge que lorsque vous en avez besoin.

Un skill est différent du plugin Shopify AI Toolkit. Le plugin vous donne accès à la documentation de Shopify, à la validation des schemas et à l’exécution de commandes sur la boutique. Un skill custom permet d’encoder vos conventions : vos modèles de sections, vos règles de nommage, votre propre checklist de révision. Ce guide couvre cette deuxième partie. Pour l’installation du plugin, consultez notre guide de setup Shopify AI Toolkit + Claude Code.

Pourquoi vous pouvez nous faire confiance

Jacques a plus de 15 ans d’expérience en développement et a travaillé avec des centaines de boutiques Shopify. Nous avons créé Fudge - un éditeur de boutique Shopify AI-native avec une note de 5.0 et un badge Built for Shopify. Nous créons des skills d’agents et des workflows Claude Code pour Shopify au quotidien.

Qu’est-ce qu’un skill Claude Code ?

Un skill étend ce que Claude sait faire à l’intérieur de Claude Code. Vous créez un fichier SKILL.md avec des instructions, et Claude l’ajoute à sa boîte à outils.¹

La mécanique est simple. Le fichier a deux parties : le frontmatter YAML entre les marqueurs --- qui indique à Claude quand utiliser le skill, et le contenu markdown qui contient les instructions que Claude suit lorsque le skill est exécuté.¹

Les skills de Claude Code respectent le standard ouvert des Agent Skills, qui fonctionne à travers de multiples outils d’IA.¹

Quelle est la différence entre un skill, un plugin ou un serveur MCP ?

Ces concepts se chevauchent, il est donc utile de clarifier la différence.

La caractéristique clé d’un skill est la divulgation progressive. La description s’intègre au contexte pour que Claude sache que le skill existe. Le corps entier du texte ne charge que lorsque le skill est utilisé. Ainsi, de longs textes de référence ne coûtent presque rien jusqu’à ce que vous en ayez besoin.¹

Quand est-ce que Claude charge un skill ?

Par défaut, Claude ou vous pouvez invoquer n’importe quel skill.¹

Vous pouvez taper /nom-du-skill pour le lancer directement. Claude peut aussi le charger automatiquement si votre prompt correspond à la description.¹ Ce comportement de chargement auto explique pourquoi une bonne description est primordiale (nous verrons cela plus bas).

Quand créer un skill vs utiliser le plugin Shopify AI Toolkit

Les deux existent. Choisissez selon ce que vous souhaitez encoder.

Le Shopify AI Toolkit connecte Claude à la documentation Shopify, aux schemas de l’API, à la validation de code, et gère votre boutique via les capacités d’exécution de la CLI.² Il répond à la question « quelle est la façon standard de faire ça sur Shopify ».

Un skill custom répond à « quelle est notre façon à nous de le faire ». Créez-en un quand :

• Vous n’arrêtez pas de copier-coller la même checklist de création de section dans le chat.¹
• Un passage de votre fichier CLAUDE.md a fini par se transformer en véritable procédure par étapes plutôt qu’en simple recommandation.¹
• Vous avez des règles de nommage, des patterns de schema ou des critères de review spécifiques à votre boutique.

Les deux fonctionnent ensemble. Installez le plugin pour être fidèle à Shopify, et ajoutez un skill par-dessus pour votre “style maison”.

Pour une vue d’ensemble du développement de thèmes orienté agents, lisez notre guide sur le développement de thèmes Shopify multi-agents.

Structure du SKILL.md et du frontmatter

Chaque skill a besoin d’un fichier SKILL.md. Le nom du dossier devient la commande que vous tapez, et la description aide Claude à décider quand charger le skill automatiquement.¹

Un skill basique ressemble à ceci :

---

name: my-skill
description: Ce que fait ce skill

---

## Instructions

Le contenu markdown que Claude va suivre lors de l'exécution du skill.

Le name et la description sont les deux champs frontmatter les plus importants.¹

Champs optionnels utiles

Le standard gère plus de frontmatter. Voici ceux pertinents pour l’univers Shopify :¹

Le champ allowed-tools octroie la permission pour les outils qu’il liste pendant l’exécution. Il ne restreint pas l’existence des autres outils : n’importe quel autre outil reste appelable, et vos réglages de permissions continuent de s’appliquer par ailleurs.¹

Structure des dossiers : où vivent les skills

Les skills se chargent depuis deux emplacements principaux.¹

Quand des skills ont le même nom sur les deux niveaux, le personnel prend le dessus sur le projet.¹

Commitez vos skills de projet dans votre système de version pour que toute votre équipe bénéficie du même comportement.¹ Un repo de thème Shopify avec un skill de scaffold de section partagé assure que chaque développeur génère ses sections de la même façon.

Inclure des fichiers annexes

Le SKILL.md est requis. Les autres fichiers sont optionnels et permettent de bâtir des skills plus robustes : comme des templates à faire remplir par Claude, des exemples de rendus, des scripts que Claude peut exécuter, ou des docs de référence pointues.¹

Un skill fait pour scaffolder des sections Shopify pourrait ressembler à ça :

~/.claude/skills/shopify-section/
├── SKILL.md              # Requis : quand + comment
├── references/
│   └── schema-rules.md   # Chargé à la demande
├── templates/
│   └── section.liquid    # Template de base
└── scripts/
    └── validate.sh       # Claude peut l'exécuter

Faites référence à ces fichiers depuis votre SKILL.md pour que Claude sache ce qu’ils contiennent et quand s’en servir.¹ Faites pointer les chemins des scripts vers ${CLAUDE_SKILL_DIR} pour qu’ils soient correctement localisés peu importe si le skill est installé au niveau personnel, de projet ou de plugin.¹

Exemple concret : un scaffolder de section Shopify

Voici un skill complet qui génère le scaffold d’une section Liquid à partir d’un prompt, et valide le résultat selon vos règles.

Étape 1 : Créer le dossier

mkdir -p ~/.claude/skills/shopify-section

Étape 2 : Rédiger le SKILL.md

Sauvegardez ceci dans ~/.claude/skills/shopify-section/SKILL.md :

---

name: shopify-section
description: Scaffolder une nouvelle section Shopify Liquid avec un bloc schema et la valider selon les règles de notre thème. À utiliser lorsque l'utilisateur demande de créer une section, d'ajouter une section, ou de construire une nouvelle section pour un thème Shopify.

---

## Scaffold d'une section Shopify

Lorsqu'il vous est demandé de créer une section :

1. Créez le fichier sous `sections/` avec un nom en kebab-case.
2. Rédigez le markup Liquid, puis ajoutez un bloc `{% schema %}` à la fin.
3. Le schema doit inclure un `name`, au moins un paramètre (setting), et une
   entrée `presets` pour que la section soit dispo via l'éditeur de thème.
4. Enveloppez la section dans un container avec un `id` unique scopé sur
   `section.id` pour que le style ne fuit pas ailleurs.
5. Ajoutez des paramètres pour le padding (haut et bas) sous forme d'inputs `range`.

## Valider avant de finaliser

- Confirmez que chaque paramètre appelé dans le markup existe bien dans le schema.
- Confirmez que le schema est un JSON valide.
- Confirmez qu'il n'y a pas de couleurs écrites en dur dans des styles inline. Référez-vous aux paramètres (settings) à la place.

Signalez toute règle enfreinte par la section et corrigez-la avant de retourner le résultat.

La description est la ligne clé du fichier. Elle nomme les commandes exactes qu’un développeur pourrait formuler : “créer une section”, “ajouter une section”, “construire une nouvelle section”. C’est sur ces expressions que Claude va se baser (matcher) pour se lancer.¹

Étape 3 : L’invoquer

Demandez quelque chose qui correspond à la description, et Claude chargera ce skill automatiquement :¹

Crée une section hero avec un titre, un sous-titre et un paramètre pour une image de fond.

Ou lancez-le directement :¹

/shopify-section

Claude lira le contenu du skill, générera la section dans sections/, et passera un coup de test sur vos règles de validation avant de vous rendre le fichier.

Si vous voulez également que le résultat soit vérifié face aux règles strictes des schemas Shopify en direct plutôt qu’uniquement les vôtres, couplez ce skill avec le plugin AI Toolkit. Le plugin gère la justesse vis-à-vis du code Shopify, et le skill gère votre style maison. Pour voir d’autres structures de prompts qui riment avec ce setup, jetez un oeil à notre guide des prompts Claude pour Shopify.

Pièges à éviter en 2026

Quelques erreurs classiques lorsqu’on écrit son premier skill.

Des descriptions vagues

Claude décide ou non de charger un skill à partir de sa description.¹ “Aide pour Shopify” est beaucoup trop flou et se lancera soit pour tout, soit pour rien.

Nommez les actions concrètes à la place : “créer une section, ajouter une section, construire une nouvelle section”. Placez votre cas d’usage principal au début, car le texte analysé est limité à 1 536 caractères, et c’est le début qui a le plus de poids.¹

Des fichiers SKILL.md surchargés

Gardez votre SKILL.md sous la barre des 500 lignes. Sortez les infos références hyper détaillées dans des fichiers séparés.¹

Le corps du fichier est chargé dans son intégralité chaque fois que le skill tourne, donc un long fichier est un coût récurrent. Placez les longues tables de schemas, les exemples interminables et la documentation des edge-cases dans le dossier references/ avec un simple lien vers eux.¹

Des permissions d’outils non révisées

Pour des skills commités au sein d’un répertoire de projet .claude/skills/, le réglage allowed-tools s’active après que vous ayez accepté la boîte de dialogue de confiance (trust dialog) du workspace.¹

Un skill peut s’auto-attribuer de larges accès aux outils. Revoyez toujours les skills locaux du projet avant de déclarer que vous avez confiance en un dépôt, de la même façon que vous évalueriez n’importe quelle règle de permission.¹

Se jeter sur un skill quand un plugin fait déjà le job

Si le toolkit officiel de Shopify fait le job, un skill custom ne sera que de la maintenance en plus. Ne vous lancez dans un skill que si vous avez besoin d’encoder des conventions que le plugin n’a aucune possibilité de connaître. Pour en savoir plus sur un setup spécifique sur d’autres éditeurs texte, dirigez-vous vers notre guide de setup Cursor pour le Shopify AI Toolkit.

Comment se positionne Fudge là-dedans

Un skill permet à Claude d’être plus rapide pour écrire du code Shopify. Mais il n’apporte pas le vrai workflow dont des modifications en direct ont besoin : brouillons (drafts), prévisualisations, approbations, et rollbacks (retours en arrière). Le code vit dans git ; pas l’état de la boutique.

Ce besoin central, c’est ce que Fudge vient combler. C’est un éditeur de boutique Shopify AI-native qui génère des brouillons respectueux de votre marque à partir d’un prompt, vous permet de les prévisualiser puis de les peaufiner, et n’effectue la publication en ligne que lorsque vous êtes prêt. Les membres de votre équipe qui ne devraient, en principe, pas toucher à du Liquid ni administrer des fichiers SKILL.md, peuvent quand même livrer de la valeur. Sur la mouvance plus globale dans laquelle tout cela s’inscrit, lisez notre point de vue sur le développement Shopify orienté IA.

Référence rapide

En résumé

Un skill Claude Code est un petit répertoire réutilisable qui enseigne vos propres conventions Shopify à Claude. Le gros du travail se divise en deux parties : une description qui dicte quand charger le skill, et un corps sous la barre des 500 lignes donnant les instructions pour que Claude sache ce qu’il a à faire.¹

Créez un skill pour votre style interne (house style). Installez le plugin AI Toolkit pour la justesse du code Shopify. Servez-vous des deux ensembles, et gardez toujours un contrôle sain de vos mises en prod via un système de brouillons et prévisualisations plutôt qu’avec une exécution sauvage dans le vide.

FAQ