# nuqs

Скилл с 39 правилами по nuqs: типизированные парсеры, адаптеры, интеграция с Server Components и оптимизация обновлений URL. Пригодится, когда агент пишет или рефакторит код с URL-состоянием.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2300 установок · ★ 218
- Автор: pproenca
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/nuqs/SKILL.md
- Обновлён: 2026-08-15
- HTML: https://affpapa.org/nevibecode/skills/nuqs

## Что делает

Скилл описывает практики работы с nuqs — библиотекой типизированного состояния в query-параметрах URL для Next.js и других React-фреймворков. Внутри 39 правил, разбитых на 8 категорий по приоритету: конфигурация парсеров и настройка адаптера идут первыми, дальше управление состоянием, интеграция с сервером, производительность, история и навигация, отладка и продвинутые приёмы. Каждое правило лежит отдельным файлом в `references/` с объяснением и примерами кода, а `AGENTS.md` собирает их в один справочник.

Агент подхватывает скилл, когда в задаче всплывают `useQueryState`, `useQueryStates`, search params, парсеры nuqs, `limitUrlUpdates`, Standard Schema, `NuqsAdapter` или маршрутизация Next.js с состоянием. Покрыты версии nuqs v2.5–v2.9, включая `createLoader`, `processUrlSearchParams` и key isolation вне Next.js. Разделы про серверную часть напоминают про `shallow:false`, `useTransition` и асинхронные `searchParams` в Next.js 15+.

Скилл ничего не запускает и не трогает ваш проект сам — это набор правил для генерации и ревью кода. Если в проекте nuqs не используется, пользы не будет: правила завязаны на его API. Для установки нужен Node.js с `npx` либо `gh` для GitHub Copilot.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill nuqs -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill nuqs -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill nuqs -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills nuqs
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill nuqs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.curated/nuqs
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill nuqs -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/nuqs/SKILL.md

## Когда брать
- выбрать типизированный парсер вместо строкового для числа или даты
- настроить NuqsAdapter и директиву 'use client' в новом проекте
- связать URL-состояние с Server Components через createSearchParamsCache
- заглушить лишние обновления URL при вводе в поиске
- разобраться, почему параметры не читаются в Next.js 15

## Примеры запросов агенту
- добавь nuqs для фильтров каталога, состояние держи в URL
- отрефактори этот компонент на useQueryStates и вынеси парсеры в отдельный файл
- почему searchParams не парсятся в Server Component — проверь по правилам nuqs

## Похожие
- [frontend-patterns](https://affpapa.org/nevibecode/skills/frontend-patterns.md) — скилл · 5900 установок
- [senior-frontend](https://affpapa.org/nevibecode/skills/senior-frontend.md) — скилл · 1630 установок
- [redux-toolkit](https://affpapa.org/nevibecode/skills/redux-toolkit.md) — скилл · 1300 установок
- [zustand-state-management](https://affpapa.org/nevibecode/skills/zustand-state-management.md) — скилл · 959 установок
- [senior-fullstack](https://affpapa.org/nevibecode/skills/borghei-senior-fullstack.md) — скилл · 311 установок
- [nextjs-code-quality-enforcer](https://affpapa.org/nevibecode/hooks/nextjs-code-quality-enforcer.md) — хук · 2249 установок

Из того же набора: [pproenca/dot-skills](https://affpapa.org/nevibecode/by/pproenca/dot-skills.md) — 45 карточек

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

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