sanity-best-practices

Vue d’ensemble du skill sanity-best-practices

Ce que fait le skill sanity-best-practices

Le skill sanity-best-practices est un pack de recommandations spécifique à Sanity pour choisir les bons modèles de contenu, de requêtes, de Studio et d’intégration avant de construire. Il est particulièrement utile si vous voulez une implémentation Sanity plus propre, moins de refactorings évitables et un chemin plus rapide entre une idée brute et un schéma ou un code frontend prêts pour la production.

Qui devrait l’utiliser

Utilisez ce sanity-best-practices skill si vous travaillez sur une base de code Sanity et que vous avez besoin d’aide pour les schemas, GROQ, TypeGen, Visual Editing, Portable Text, la localisation, les migrations, Functions, Blueprints, ou des intégrations framework comme Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen ou l’App SDK. C’est un excellent choix pour les développeurs frontend, les équipes qui construisent des plateformes de contenu et les équipes qui auditent une configuration Sanity existante.

Pourquoi l’installer vaut le coup

La valeur principale, c’est la qualité des décisions : le skill vous aide à éviter les prompts génériques qui passent à côté des contraintes propres à Sanity, par exemple quand utiliser defineQuery, comment structurer des requêtes pour garantir la sécurité des types, ou quand une fonctionnalité doit vivre dans le Studio plutôt que dans le frontend. Si vous cherchez un sanity-best-practices guide qui vous aide à avancer avec moins d’hypothèses, ce skill est plus utile qu’un simple prompt large du type « aide-moi avec Sanity ».

Comment utiliser le skill sanity-best-practices

Installez-le et ouvrez d’abord les bons fichiers

Utilisez le flux sanity-best-practices install dans votre chaîne d’outils de skills, puis commencez par SKILL.md pour confirmer le périmètre. Ensuite, lisez uniquement les fichiers thématiques qui correspondent à votre tâche ; le dépôt est organisé en pages de référence ciblées, pas en un long manuel unique. Pour la plupart des cas, les premières lectures les plus utiles sont references/get-started.md, references/schema.md, references/groq.md, references/typegen.md et le fichier framework pertinent.

Transformez une tâche floue en entrée exploitable

Le skill donne les meilleurs résultats quand vous lui fournissez la cible concrète, pas seulement la technologie. Au lieu de dire « améliore ma config Sanity », dites : « Revois ce schéma de page builder Next.js + Sanity et propose des changements best practice pour TypeGen, GROQ et Visual Editing. » Pour une demande de sanity-best-practices usage, indiquez le framework, la version de Sanity, le fichier actuel et le mode de défaillance : types cassés, requêtes lentes, décalage de prévisualisation ou modélisation de contenu maladroite.

Lisez le dépôt selon la tâche, pas par réflexe

Utilisez le fichier de référence qui correspond au travail :

• references/schema.md pour les modèles de contenu, defineType et defineField
• references/groq.md pour la structure des requêtes et la sécurité des requêtes
• references/visual-editing.md pour les setups de preview et de Presentation
• references/typegen.md pour les schémas typés et les requêtes typées
• references/nextjs.md, references/astro.md, references/nuxt.md ou d’autres fichiers framework pour les détails d’intégration
• references/functions.md et references/blueprints.md pour l’automatisation pilotée par événements et l’infrastructure

Utilisez un format de prompt qui fait apparaître les contraintes

Un bon prompt inclut généralement : ce que vous construisez, le fichier que vous voulez faire relire, le framework utilisé et ce qui ne doit pas changer. Exemple : « Audite ce schéma post pour la localisation et les bonnes pratiques de Portable Text. Garde l’API publique stable, conserve si possible les noms de champs existants et explique toute rupture potentielle. » Ce niveau de précision aide le skill à produire un résultat sanity-best-practices usage réellement exploitable, au lieu de conseils génériques.

FAQ du skill sanity-best-practices

Ce skill est-il réservé aux nouveaux projets Sanity ?

Non. Le skill sanity-best-practices est tout aussi utile quand vous corrigez un projet existant, surtout si vous devez réduire la dérive des schémas, améliorer la maintenabilité des requêtes ou aligner le frontend avec le comportement du Studio.

En quoi est-ce différent d’un prompt classique ?

Un prompt classique demande généralement une réponse isolée. Ce skill vous donne un workflow centré sur Sanity et un chemin de référence afin que le résultat reflète les bonnes pratiques pour les schémas, GROQ, les previews, TypeGen et l’intégration framework, plutôt qu’un conseil JavaScript générique.

Est-ce adapté aux débutants ?

Oui, si vous savez déjà que vous travaillez dans Sanity. Ce n’est pas un cours d’onboarding débutant à lui seul, mais il réduit la confusion en vous orientant vers le bon fichier thématique au lieu de vous laisser deviner quelle fonctionnalité Sanity s’applique.

Quand ne faut-il pas l’utiliser ?

Évitez-le si votre problème n’est pas spécifique à Sanity, ou si vous n’avez besoin que d’une petite modification ponctuelle sans décision de modélisation, de requête ou d’intégration. Ce n’est pas non plus le bon choix si vous cherchez une session de débogage frontend pure, sans lien avec le flux de contenu Sanity.

Comment améliorer le skill sanity-best-practices

Donnez au skill la vraie décision à prendre

Les meilleurs résultats viennent d’un vrai arbitrage clairement formulé : « Ce champ doit-il être une référence ou un objet inline ? » ou « Cette requête doit-elle vivre dans le frontend ou être normalisée dans le schéma ? » C’est plus efficace qu’une demande de nettoyage globale, parce que le skill peut alors optimiser l’architecture, pas seulement la syntaxe.

Incluez la forme actuelle du code

Collez le schéma, la requête ou l’extrait d’intégration que vous voulez faire relire, ainsi que suffisamment de contexte autour pour montrer comment le contenu circule dans le système. Pour sanity-best-practices for Frontend Development, précisez le framework, le mode de rendu et si vous avez besoin de preview, de SSR, d’un build statique ou de mises à jour en direct.

Demandez l’itération suivante, pas seulement la première réponse

Après le premier passage, demandez au skill de resserrer la solution autour d’un objectif : sécurité des types, expérience éditeur, performances des requêtes ou clarté de la création de contenu. Les échecs les plus courants sont les schémas trop normalisés, les filtres GROQ trop peu précis et le code frontend qui ne correspond pas aux hypothèses du Studio. Le gain le plus rapide vient souvent de contraintes supplémentaires et d’une version révisée avec moins de pièces mobiles.

Appuyez-vous sur des preuves du dépôt pour rester aligné

En cas de doute, ancrez votre relance dans le chemin de fichier de référence pertinent, comme references/localization.md, references/migration.md ou references/page-builder.md. Cela permet de garder le sanity-best-practices skill aligné sur les patterns voulus par le dépôt et rend le résultat final plus simple à implémenter.