Créer un Custom Skill Claude Code pour Shopify

À retenir

• Une skill Claude Code est un dossier contenant un fichier SKILL.md. Le frontmatter indique à Claude quand l’utiliser. Le corps lui indique quoi faire.¹
• Les skills personnelles se trouvent dans ~/.claude/skills/<name>/SKILL.md. Les skills de projet se trouvent dans .claude/skills/<name>/SKILL.md et peuvent être commitées sur git.¹
• Créez une skill quand vous n’arrêtez pas de 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 schéma et de l’exécution sur la boutique.²
• Claude charge une skill automatiquement quand votre requête correspond à sa description, ou si vous l’invoquez directement avec /skill-name.¹
• Gardez SKILL.md sous les 500 lignes. Déplacez les longs documents de référence dans des fichiers séparés inclus dans le bundle.¹

Ce tutoriel sur les skills Shopify pour Claude Code vous explique comment créer votre propre skill d’agent pour votre travail sur Shopify : un fichier SKILL.md réutilisable qui génère la structure d’une section Liquid, la vérifie selon les règles de votre équipe, et ne se charge que lorsque vous en avez besoin.

Une skill est différente du plugin Shopify AI Toolkit. Le plugin vous donne accès à la documentation de Shopify, à la validation des schémas et à l’exécution sur la boutique. Une skill personnalisée encode vos conventions : vos modèles de sections, vos règles de nommage, votre checklist de review. Ce guide couvre le deuxième point. Pour la configuration du plugin, consultez notre guide de configuration 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 natif IA avec une note de 4.9 et le badge Built for Shopify. Nous créons quotidiennement des skills d’agents et des workflows Claude Code pour Shopify.

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 fonctionnalités se chevauchent, il est donc utile de préciser la différence.

La caractéristique principale d’une skill est la divulgation progressive. La description reste dans le contexte pour que Claude sache que la skill existe. Le corps complet ne se charge que lorsque la skill est utilisée. Les documents de référence longs 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 en fonction de ce que vous voulez encoder.

Le Shopify AI Toolkit connecte Claude à la doc de Shopify, aux schémas d’API et à la validation de code, et peut gérer votre boutique via la capacité d’exécution de la CLI.² Il répond à la question « quelle est la bonne façon de faire ça selon Shopify ? ».

Une skill personnalisée répond à « quelle est notre façon de faire ça ? ». Créez-en une quand :

• Vous n’arrêtez pas de coller la même checklist de génération de sections dans le chat.¹
• Une section de votre CLAUDE.md s’est transformée en une procédure plutôt qu’un simple fait.¹
• Vous avez des règles de nommage, des modèles de schéma ou une checklist de review spécifiques à votre boutique.

Les deux fonctionnent ensemble. Installez le plugin pour la précision côté Shopify. Ajoutez une skill par-dessus pour votre propre style maison.

Pour une vue d’ensemble du travail sur les thèmes basé sur des agents, consultez 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 supporte plus d’éléments dans le frontmatter. En voici quelques-uns qui comptent pour le travail sur Shopify :¹

Le champ allowed-tools donne l’autorisation pour les outils listés pendant l’exécution de la skill. Il ne restreint pas les outils existants. Chaque outil reste appelable, et vos paramètres de permission continuent de régir le reste.¹

Structure des dossiers : où vivent les skills

Les skills se chargent depuis deux emplacements principaux.¹

Quand des skills partagent un nom à différents niveaux, la personnelle l’emporte sur celle du projet.¹

Commitez les skills de projet dans votre gestionnaire de version pour que toute votre équipe obtienne le même comportement.¹ Un repo de thème Shopify avec une skill partagée pour générer des sections signifie que chaque développeur crée ses sections de la même manière.

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