Sanity Best Practices
sanity-io/agent-toolkit
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, webhooks, Blueprints…
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and…
Install Sanity Best Practices
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practices --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/sanity-best-practices .claude/skills/sanity-best-practices && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .claude/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practicesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practices --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/sanity-best-practices .agents/skills/sanity-best-practices && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .agents/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practices --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/sanity-best-practices .cursor/skills/sanity-best-practices && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .cursor/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/robotostudio/turbo-start-sanity.git --path .claude/skills/sanity-best-practices--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practices --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/sanity-best-practices .gemini/skills/sanity-best-practices && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .gemini/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practicesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/sanity-best-practices .github/skills/sanity-best-practices && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .github/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install robotostudio/turbo-start-sanity sanity-best-practices --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robotostudio/turbo-start-sanity.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/sanity-best-practices .opencode/skills/sanity-best-practices && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "sanity-best-practices" agent skill from https://github.com/robotostudio/turbo-start-sanity/tree/main/.claude/skills/sanity-best-practices into .opencode/skills/sanity-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sanity-best-practices", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
sanity-best-practices- GitHub stars
- 183
- Token cost
- ~940 tokens
- SKILL.md length
- 345 words
- Files
- 25 (incl. references)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and…
- Working with Sanity schemas
- SKILL.md covers When to Apply, Quick Reference and How to Use
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Content modeling
What it does
Sanity Best Practices is an agent skill from robotostudio/turbo-start-sanity. Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK. Use this skill whenever working with Sanity schemas, defineType or defineField, GROQ or defineQuery, content modeling, Presentation or preview setups, Sanity-powered frontend integrations, Sanity Functions…
Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files, including reference files (for example `references/angular.md`, `references/app-sdk.md` and `references/astro.md`).
It sits in Frontend & Design, covering Static sites and blogs, Internationalization and Database schema design. It works with Next.js, Nuxt, Astro and Angular. The repository describes itself as: Sanity + Next.js page-builder template. The licence is MIT.
When your agent uses it
- Working with Sanity schemas
- Content modeling
- Sanity-powered frontend integrations
- Sanity Functions
Example prompts
- “/sanity-best-practices”
What it can do on your machine
Read from SKILL.md and the folder at commit 8155b99. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Sanity Best Practices loads about 940 tokens when it runs, and up to ~46k if it reads all its reference files. Until then it costs about 187 tokens; SKILL.md has 345 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from robotostudio/turbo-start-sanity at commit 8155b99, republished under its MIT licence (© robotostudio). 345 words, ~940 tokens.
Download SKILL.mdSave it as
.claude/skills/sanity-best-practices/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.- name
- sanity-best-practices
- description
- Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK. Use this skill whenever working with Sanity schemas, defineType or defineField, GROQ or defineQuery, content modeling, Presentation or preview setups, Sanity-powered frontend integrations, Sanity Functions, documentEventHandler, defineDocumentFunction, defineMediaLibraryAssetFunction, @sanity/functions, @sanity/blueprints, sanity.blueprint.ts, event-driven content automation, or when reviewing and fixing a Sanity codebase.
Sanity Best Practices
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.
When to Apply
Reference these guidelines when:
- Setting up a new Sanity project or onboarding
- Integrating Sanity with a frontend framework (Next.js, Nuxt, Astro, Remix, SvelteKit, Hydrogen)
- Writing GROQ queries or optimizing performance
- Designing content schemas
- Implementing Visual Editing and live preview
- Working with images, Portable Text, or page builders
- Configuring Sanity Studio structure
- Setting up TypeGen for type safety
- Implementing localization
- Migrating content from other systems
- Building custom apps with the Sanity App SDK
- Managing infrastructure with Blueprints
- Automating content workflows with Sanity Functions
Quick Reference
Integration Guides
get-started- Interactive onboarding for new Sanity projectsnextjs- Next.js App Router, Live Content API, embedded 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- Monorepo and embedded Studio patternsapp-sdk- Custom applications with Sanity App SDKblueprints- Infrastructure as Code with Sanity Blueprintsfunctions- Automating content workflows with Sanity Functions
Topic Guides
groq- 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 alsomigration-html-import)migration-html-import- HTML to Portable Text with @portabletext/block-tools
How to Use
Start 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.mdEach reference file contains:
- Comprehensive topic or integration coverage
- Incorrect and correct code examples
- Decision matrices and workflow guidance
- Framework-specific patterns where applicable
© robotostudio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 24 other files (references) in .claude/skills/sanity-best-practices of robotostudio/turbo-start-sanity.
- SKILL.md
- references/angular.md
- references/app-sdk.md
- references/astro.md
- references/blueprints.md
- references/functions.md
- references/get-started.md
- references/groq.md
- references/hydrogen.md
- references/image.md
- references/localization.md
- references/migration-html-import.md
- references/migration.md
- references/nextjs.md
- references/nuxt.md
- references/page-builder.md
- references/portable-text.md
- references/project-structure.md
- references/remix.md
- references/schema.md
- … and 5 more
Open the folder on GitHubat commit 8155b99
Compare with similar skills
Sanity Best Practices next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Sanity Best Practices this skillrobotostudio/turbo-start-sanity | 183 | — | ~940 | Automated safety check: Pass | MIT | |
| Sanity Best Practicessanity-io/agent-toolkit | 188 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Cloudflare Workers Frameworkssecondsky/claude-skills | 227 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Edgeone Makers FrameworksTencentEdgeOne/edgeone-makers-tools | 1.9k | — | ~2.5k | Automated safety check: Pass | MIT | |
| App BuilderUndertone0809/rudder | 292 | — | ~2k | Automated safety check: Pass | Apache-2.0 | |
| Vue Nuxtericrisco/rsc-harness | 180 | — | ~4.2k | Automated safety check: Pass | MIT |
Similar skills
- Official
Cloudflare Workers Frameworks
secondsky/claude-skills
Framework integration for Cloudflare Workers. An agent skill from secondsky/claude-skills.
Edgeone Makers Frameworks
TencentEdgeOne/edgeone-makers-tools
Web framework support matrix for EdgeOne Makers — which platform adapter each full-stack framework needs, where it plugs in, the build output directory, the preview asset-prefix option, the 404…
App Builder
Undertone0809/rudder
Create and iteratively improve local web products from natural-language requests, then prepare them to run as Rudder Apps.
Vue Nuxt
ericrisco/rsc-harness
A skill your agent uses when building or reviewing a Vue 3 + Nuxt 4 app — <script setup reactivity, SSR/SSG/hybrid routeRules, the app/+server/ layout, SSR-safe fetching (useFetch/useAsyncData) and…
Framework Adapters
hashgraph-online/awesome-codex-plugins
Official @dodopayments/ framework adapters that mount Checkout, CustomerPortal, and Webhooks route handlers.
More from robotostudio/turbo-start-sanity
New Block
robotostudio/turbo-start-sanity
Scaffold a new page builder block for Turbo Start Sanity end-to-end — Sanity schema, GROQ projection, styled React component, Markdown serializer, tests, and all registrations.
Sanity Live Cache Components
robotostudio/turbo-start-sanity
Integrates Sanity Live with Next.js Cache Components in next-sanity v13+ apps.
Related
Categories
Questions about Sanity Best Practices
What does Sanity Best Practices do?
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and…. Sanity Best Practices is an agent skill from robotostudio/turbo-start-sanity.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK.
When should I use Sanity Best Practices?
Sanity Best Practices fits situations like: working with Sanity schemas; content modeling; sanity-powered frontend integrations; sanity Functions.
How do I install Sanity Best Practices in Claude Code?
Run `npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a claude-code`. Or copy the skill folder (.claude/skills/sanity-best-practices in robotostudio/turbo-start-sanity) into .claude/skills/sanity-best-practices in your project. Claude Code loads it when a task matches its description.
How do I install Sanity Best Practices in Codex?
Run `npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a codex`. Or copy the skill folder (.claude/skills/sanity-best-practices in robotostudio/turbo-start-sanity) into .agents/skills/sanity-best-practices in your project. Codex loads it when a task matches its description.
Can I use Sanity Best Practices in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add robotostudio/turbo-start-sanity --skill sanity-best-practices -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sanity-best-practices, .gemini/skills/sanity-best-practices, .github/skills/sanity-best-practices and .opencode/skills/sanity-best-practices in your project.
What does Sanity Best Practices need to run?
SKILL.md names no scripts, command-line tools or credentials: Sanity Best Practices is instructions for the agent only.
Does Sanity Best Practices access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Sanity Best Practices safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Sanity Best Practices use?
Sanity Best Practices is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Sanity Best Practices use?
About 940 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 45k tokens, read only when the agent opens those files.
What are the alternatives to Sanity Best Practices?
Skills that share tags, products or a category with Sanity Best Practices: Sanity Best Practices (sanity-io/agent-toolkit, 188 stars), Cloudflare Workers Frameworks (secondsky/claude-skills, 227 stars), Edgeone Makers Frameworks (TencentEdgeOne/edgeone-makers-tools, 1.9k stars) and App Builder (Undertone0809/rudder, 292 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Sanity Best Practices?
robotostudio (a GitHub organization) maintains it in robotostudio/turbo-start-sanity, which has 183 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 5, 2026.
Source: robotostudio/turbo-start-sanity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.