From sanity
Provides Sanity development best practices for schema design, GROQ queries, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and framework integrations (Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen).
How this skill is triggered — by the user, by Claude, or both
Slash command
/sanity:sanity-best-practicesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Comprehensive best practices and integration guides for Sanity development, maintained by Sanity. Use the quick reference below to load only the one or two topic files that match the task.
references/angular.mdreferences/app-sdk.mdreferences/astro.mdreferences/blueprints.mdreferences/functions.mdreferences/get-started.mdreferences/groq.mdreferences/hydrogen.mdreferences/image.mdreferences/localization.mdreferences/migration-html-import.mdreferences/migration.mdreferences/nextjs.mdreferences/nuxt.mdreferences/page-builder.mdreferences/portable-text.mdreferences/project-structure.mdreferences/remix.mdreferences/schema.mdreferences/seo.mdComprehensive best practices and integration guides for Sanity development, maintained by Sanity. Use the quick reference below to load only the one or two topic files that match the task.
Reference these guidelines when:
_id values for ordinary documents. Do not create deterministic UUIDs, slug-derived IDs, or legacy-system IDs when creating documents.reference fields, then resolve related documents with GROQ lookups, source-key fields, or returned _id values from created documents.homePage-en.get-started - Interactive onboarding for new Sanity projectsnextjs - Next.js App Router, Live Content API, standalone Studionuxt - Nuxt integration with @nuxtjs/sanityangular - Angular integration with @sanity/client, signals, resource APIastro - Astro integration with @sanity/astroremix - React Router / Remix integrationsvelte - SvelteKit integration with @sanity/svelte-loaderhydrogen - Shopify Hydrogen with Sanityproject-structure - Standalone Studio and monorepo patternsapp-sdk - Custom applications with Sanity App SDKblueprints - Infrastructure as Code with Sanity Blueprintsfunctions - Automating content workflows with Sanity Functionsgroq - GROQ query patterns, type safety, performance optimizationschema - Schema design, field definitions, validation, deprecation patternsvisual-editing - Presentation Tool, Stega, overlays, live previewpage-builder - Page Builder arrays, block components, live editingportable-text - Rich text rendering and custom componentsimage - Image schema, URL builder, hotspots, LQIP, Next.js Imagestudio-structure - Desk structure, singletons, navigationtypegen - TypeGen configuration, workflow, type utilitiesseo - Metadata, sitemaps, Open Graph, JSON-LDlocalization - i18n patterns, document vs field-level, locale managementmigration - Content import overview (see also migration-html-import)migration-html-import - HTML to Portable Text with @portabletext/block-toolsStart with the single framework or topic guide that best matches the request, then read additional references only when the task crosses concerns. Use these reference files for detailed explanations and code examples:
references/groq.md
references/schema.md
references/nextjs.md
Each reference file contains:
npx claudepluginhub sanity-io/agent-toolkit --plugin sanityDesigns structured content models for headless CMSes: schema design, content reuse, reference vs. embedded objects, separation of concerns, taxonomies. Use when creating or refactoring content types.
Integrates Sveltia CMS, lightweight Git-backed headless CMS for static sites (Hugo, Jekyll, 11ty, Gatsby, Astro, Next.js). Use for blogs, docs, i18n, OAuth/TOML/CORS errors.
Provides expert guidance on Webflow CMS architecture and best practices for planning collections, setting up relationships, optimizing content structure, and troubleshooting issues.