# sanity-form-component-suspense

Скилл sanity-form-component-suspense для Claude Code устраняет предупреждения о нехватке границ Suspense в кастомных полях Sanity Studio. Срабатывает при сдвигах вёрстки из-за React.lazy или хуков App SDK.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 271 установка · ★ 201 у репозитория
- Автор: sanity-io
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sanity-io/agent-toolkit/tree/HEAD/skills/sanity-form-component-suspense/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/sanity-form-component-suspense

## Что делает

Скилл находит кастомные компоненты ввода, полей и элементов списков Sanity Studio, которые асинхронно запрашивают данные и не имеют собственной границы `<Suspense>`. По умолчанию Studio оборачивает всё поле в универсальный скелетон, из-за чего форма дёргается при загрузке, а в консоль сыплются предупреждения.

Агент выносит асинхронный код с `React.lazy`, `use()` или хуками вроде `useDocumentProjection` в отдельный компонент и задаёт для скелетона точную высоту строки. Вызов `props.renderDefault` остаётся снаружи границы, поэтому стандартное поле не теряет фокус при повторной загрузке данных.

На ещё не сохранённых документах хуки SDK ждут бесконечно, поэтому скилл добавляет проверку `_createdAt` через `useFormValue`. Без этой проверки форма нового документа зависает со скелетоном навсегда.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sanity-io/agent-toolkit --skill sanity-form-component-suspense -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/sanity-form-component-suspense/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/sanity-form-component-suspense/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sanity-io/agent-toolkit --skill sanity-form-component-suspense -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/sanity-form-component-suspense/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sanity-io/agent-toolkit --skill sanity-form-component-suspense -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/sanity-form-component-suspense/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sanity-io/agent-toolkit skills/sanity-form-component-suspense
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/sanity-form-component-suspense/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sanity-io/agent-toolkit --skill sanity-form-component-suspense -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/sanity-io/agent-toolkit --path skills/sanity-form-component-suspense
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/sanity-form-component-suspense/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add sanity-io/agent-toolkit --skill sanity-form-component-suspense -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sanity-io/agent-toolkit/tree/HEAD/skills/sanity-form-component-suspense/SKILL.md

## Когда брать
- убрать предупреждения консоли о компонентах Sanity Studio без Suspense
- предотвратить сдвиг интерфейса при асинхронной загрузке полей
- сохранить фокус ввода при повторной загрузке асинхронных данных
- починить вечный скелетон на новых несохранённых документах

## Примеры запросов агенту
- Оберни асинхронный селектор в схеме `schema/product.ts` в собственную границу Suspense
- Исправь предупреждение консоли о компоненте без Suspense в кастомном поле Sanity
- Почини зависающий скелетон при создании нового документа в Sanity Studio

## Похожие
- [nextjs-use-search-params-suspense](https://affpapa.org/nevibecode/skills/nextjs-use-search-params-suspense.md) — скилл · 313 установок
- [async-suspense-boundaries](https://affpapa.org/nevibecode/rules/async-suspense-boundaries.md) — правило · ★ 7191 у репозитория
- [loading-suspense](https://affpapa.org/nevibecode/rules/loading-suspense.md) — правило · ★ 4719 у репозитория
- [sanity-live-cache-components](https://affpapa.org/nevibecode/skills/sanity-live-cache-components.md) — скилл · 602 установки
- [sanity](https://affpapa.org/nevibecode/skills/sanity.md) — скилл · 767 установок
- [dynamic-import](https://affpapa.org/nevibecode/skills/dynamic-import.md) — скилл · 1700 установок

Из того же набора: [sanity-io/agent-toolkit](https://affpapa.org/nevibecode/by/sanity-io/agent-toolkit.md) — 12 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
