Nuqs

If you're managing state in the URL with nuqs, this gives you 42 prioritized rules across parser config, adapter setup, server integration, and performance optimization. The critical stuff (parser configuration, NuqsAdapter setup) comes first, then high-impact patterns for Server Components and useQueryStates, down to advanced topics like custom parsers and Standard Schema integration. Covers Next.js 15 async searchParams, limitUrlUpdates for debouncing, and the newer key isolation behavior in v2.5+. What's useful here is the priority ordering, so you're not treating clearOnDefault the same as getting your parser types right. Good reference when you're past the basics and need to know the correct way to handle controlled inputs or share parsers between client and server.

skills.sh installs: 2.4K
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill nuqs --agent claude-code

Installs into .claude/skills of the current project.

Files

Community nuqs Best Practices for Next.js & React

Comprehensive guide for type-safe URL query state management with nuqs across Next.js, React Router, TanStack Router, Remix, and plain React. Covers nuqs v2.5–v2.9 features. Contains 39 rules across 8 categories, prioritized by impact to guide code generation, refactoring, and code review.

When to Apply

Reference these guidelines when:

Implementing URL-based state with nuqs
Setting up nuqs in a Next.js or React Router project
Configuring parsers for URL parameters
Integrating URL state with Server Components
Optimizing URL update performance (limitUrlUpdates, key isolation)
Sharing parser definitions with tRPC / TanStack Router / forms via Standard Schema
Debugging nuqs-related issues