sanity-best-practices agent skill by sanity-io
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, webhooks, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, the App SDK, and Studios or apps running in the Sanity Dashboard (defineApplication). Use this skill whenever working with Sanity schemas, defineType or defineField, GROQ or defineQuery, content modeling, Presentation or preview setups, Sanity-powered frontend integrations, event-driven content automation, documentEventHandler, defineDocumentFunction, defineMediaLibraryAssetFunction, @sanity/functions, @sanity/blueprints, sanity.blueprint.ts, event-driven content automation, or when reviewing and fixing a Sanity codebase.
Source and license
| Publisher | sanity-io |
|---|---|
| Repository | sanity-io/agent-toolkit |
| License | MIT |
| Snapshot | 2026-10-22 |
| Last repository commit | 2026-10-12 |
| Instruction size | 675 words; 83 lines |
| Bundled files | 26 |
Suede Skill Check: 79/100 · C
Report snapshot · · graded-v2
The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.
Source revision: feb9d3841242. Report version a52c2eea605e. Badge URLs follow the latest listing; save the report to keep this version.
Download report · Request a fresh review
What to review next
- Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
- Example request: 0 of 3 points. 3 when the description quotes an example request (3–60 characters in quotation marks).
- Description length: 3 of 5 points. 5 for 150–600 characters; 3 for 100–900; 1 for 50–1,024.
Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.
| Component | Points earned | Available |
|---|---|---|
| Structural checks | 56 | 56 |
| Description length | 3 | 5 |
| Boundary clause | 0 | 4 |
| Example request | 0 | 3 |
| Instruction depth | 7 | 7 |
| Reference files | 3 | 3 |
| Bundled scripts | 0 | 2 |
| Recent maintenance | 9 | 9 |
| Curated-list citations | 1 | 7 |
| Tool permissions declared | 0 | 2 |
| Compatibility declared | 0 | 2 |
The published score is capped at 99. It measures the published files, documentation and maintenance signals. Security scan: not scanned. This assessment does not include a runtime test or a full installation-dependency review.
Install sanity-best-practices
The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.
npx skills add https://github.com/sanity-io/agent-toolkit/tree/main/skills/sanity-best-practices
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/sanity-io/agent-toolkit.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/sanity-best-practices .claude/skills/
rm -rf "$tmp"
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/sanity-io/agent-toolkit.git "$tmp/repo"
mkdir -p .agents/skills
cp -R "$tmp/repo/"skills/sanity-best-practices .agents/skills/
rm -rf "$tmp"
For a user-level install, copy the folder to ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex). Inside Codex, $skill-installer can also fetch a skill from GitHub. New to skills? Read How to install agent skills in Claude Code, Codex and Cursor.
sanity-io/agent-toolkit is third-party code. Read SKILL.md and any bundled scripts before you install it.
Show the listing and raise the score
sanity-best-practices is listed with 79/100 · C. This badge links to its Suede AI listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for sanity-best-practices are boundary clause (4), example request (3) and bundled scripts (2). Send your repository and the points you want to raise, then request a fresh review after updating the skill. Publishers: read How to get your agent skill found in search and cited by AI assistants.
[](https://suedeai.directory/sanity-io/agent-toolkit/sanity-best-practices/)
<a href="https://suedeai.directory/sanity-io/agent-toolkit/sanity-best-practices/"><img src="https://suedeai.directory/badge.svg" alt="Suede AI Skills Directory: listed" height="20"></a>
Compare skills for this task
Browse frontend-design skills or compare scores side by side.