docs: fix schema.md icon examples for @sanity/icons v5 subpath imports (#66)

* docs: fix schema.md icon examples for @sanity/icons v5 subpath imports

@sanity/icons v5 (pulled in transitively by sanity ^6.7.0) removed named
icon exports from the package root; only the icons map and Icon component
remain there, with named icons moved to per-icon subpaths. The root's
type declarations still declare the old names (as `never`, with a
deprecation note), so the old import style type-checks but crashes
Sanity Studio at runtime.

Update schema.md's icon import example and content-type table to use
the v5 subpath style (e.g. `@sanity/icons/DocumentText`) so agents
following this skill don't ship a working build that crashes in the
browser.

* docs: fix @sanity/icons v5 subpath imports in localization, page-builder, seo refs

Same broken root-import pattern fixed in schema.md: @sanity/icons v5
removed named icon exports from the package root, so the old
`import { XIcon } from '@sanity/icons'` style type-checks but crashes
Sanity Studio at runtime. Update the icon import examples in
localization.md, page-builder.md, and seo.md to the v5 per-icon
subpath style (e.g. `@sanity/icons/Home`).

* docs: trim icon-import explanation to the code examples

The mechanism paragraph explained internals an agent never acts on, and
claimed the bad import "crashes Studio at runtime". It doesn't — Vite
and esbuild both fail the bundle with `"DocumentTextIcon" is not
exported by @sanity/icons`, so `sanity build` errors immediately.

Keep the ✅/❌ pair and the table's Import column (the parts that change
behavior), and correct the failure mode in the ❌ comment.

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Rune Botten <rbotten@gmail.com>

Author: 3 people

skills/sanity-best-practices/references/localization.md

@@ -43,7 +43,7 @@ Don't create nearly identical copies with slight differences (e.g., US vs Britis
 
 ```typescript
 // schemaTypes/locale.ts
-import { TranslateIcon } from '@sanity/icons'
+import { TranslateIcon } from '@sanity/icons/Translate'
 import { defineField, defineType } from 'sanity'
 
 export const localeType = defineType({
@@ -167,7 +167,7 @@ For singletons like homepages that need a separate document per locale, combine
 
 ```typescript
 // schemaTypes/homePage.ts
-import { HomeIcon } from '@sanity/icons'
+import { HomeIcon } from '@sanity/icons/Home'
 import { defineType, defineField } from 'sanity'
 
 export const homePageType = defineType({
@@ -237,7 +237,7 @@ Create a helper to show one singleton per locale in the Structure:
 ```typescript
 // src/structure/index.ts
 import { StructureBuilder, StructureResolver } from 'sanity/structure'
-import { HomeIcon } from '@sanity/icons'
+import { HomeIcon } from '@sanity/icons/Home'
 
 const LOCALES = ['en', 'fr', 'de']
 

skills/sanity-best-practices/references/page-builder.md

@@ -74,7 +74,7 @@ Every block should have consistent previews:
 
 ```typescript
 import { defineType } from "sanity";
-import { BlockContentIcon } from "@sanity/icons";
+import { BlockContentIcon } from "@sanity/icons/BlockContent";
 
 export const splitImageType = defineType({
   name: "splitImage",

skills/sanity-best-practices/references/schema.md

@@ -36,7 +36,7 @@ Always use the helper functions from `sanity` for type safety and autocompletion
 
 ```typescript
 import { defineType, defineField, defineArrayMember } from 'sanity'
-import { TagIcon } from '@sanity/icons'
+import { TagIcon } from '@sanity/icons/Tag'
 
 export const article = defineType({
   name: 'article',
@@ -114,17 +114,26 @@ Every item in a Sanity array automatically gets a `_key` property. This is **cri
 ### B. Icons
 Always assign an icon from `@sanity/icons` to documents and objects. This improves the Studio UX significantly. Browse all icons at [icons.sanity.build](https://icons.sanity.build/all).
 
-| Content Type | Icon |
-|--------------|------|
-| Article, Post | `DocumentTextIcon` |
-| Author, Person | `UserIcon` |
-| Category, Tag | `TagIcon` |
-| Settings | `CogIcon` |
-| Page | `DocumentIcon` |
-| Image block | `ImageIcon` |
-| Video block | `PlayIcon` |
-| FAQ | `HelpCircleIcon` |
-| Link | `LinkIcon` |
+```typescript
+// ✅ Correct — import each icon from its own subpath
+import { DocumentTextIcon } from '@sanity/icons/DocumentText'
+
+// ❌ Wrong — root named exports were removed in v5.
+// Type-checks clean, then fails at bundle time.
+import { DocumentTextIcon } from '@sanity/icons'
+```
+
+| Content Type | Icon | Import |
+|--------------|------|--------|
+| Article, Post | `DocumentTextIcon` | `@sanity/icons/DocumentText` |
+| Author, Person | `UserIcon` | `@sanity/icons/User` |
+| Category, Tag | `TagIcon` | `@sanity/icons/Tag` |
+| Settings | `CogIcon` | `@sanity/icons/Cog` |
+| Page | `DocumentIcon` | `@sanity/icons/Document` |
+| Image block | `ImageIcon` | `@sanity/icons/Image` |
+| Video block | `PlayIcon` | `@sanity/icons/Play` |
+| FAQ | `HelpCircleIcon` | `@sanity/icons/HelpCircle` |
+| Link | `LinkIcon` | `@sanity/icons/Link` |
 
 ### C. Boolean vs. List
 Avoid boolean fields for binary states that might expand later.

skills/sanity-best-practices/references/seo.md

@@ -193,7 +193,7 @@ Create a redirect document type for content team management.
 ```typescript
 // schemaTypes/redirectType.ts
 import { defineField, defineType, SanityDocumentLike } from "sanity";
-import { LinkIcon } from "@sanity/icons";
+import { LinkIcon } from "@sanity/icons/Link";
 
 function isValidPath(value: string | undefined) {
   if (!value) return "Required";