Individual skill
nuqs
nuqs (type-safe URL query state) best practices for Next.js and other React frameworks. This skill should be used when writing, reviewing, or refactoring code that uses nuqs for URL state management. Triggers on tasks involving useQueryState, useQueryStates, search params, URL state, query parameters, nuqs parsers, limitUrlUpdates, Standard Schema, NuqsAdapter, or Next.js routing with state.
skills/.curated/nuqs/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
- writing Derived category
- engineering Derived category
- engineering-web Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 8,711 bytesREADME.mddoc · 2,826 bytesSKILL.mdcore · 6,963 bytesassets/templates/_template.mddoc · 886 bytesmetadata.jsonasset · 1,265 bytesreferences/_sections.mddoc · 1,670 bytesreferences/advanced-custom-parsers.mddoc · 2,739 bytesreferences/advanced-eq-function.mddoc · 2,326 bytesreferences/advanced-framework-adapters.mddoc · 2,629 bytesreferences/advanced-process-url-search-params.mddoc · 2,925 bytesreferences/advanced-url-keys.mddoc · 1,593 bytesreferences/debug-enable-logging.mddoc · 1,554 bytesreferences/debug-testing.mddoc · 1,552 bytesreferences/history-push-navigation.mddoc · 2,623 bytesreferences/history-scroll-behavior.mddoc · 1,751 bytesreferences/parser-array-format.mddoc · 1,922 bytesreferences/parser-date-format.mddoc · 2,035 bytesreferences/parser-enum-validation.mddoc · 2,040 bytesreferences/parser-index-offset.mddoc · 1,821 bytesreferences/parser-json-validation.mddoc · 3,079 bytesreferences/parser-use-typed-parsers.mddoc · 1,520 bytesreferences/parser-with-default.mddoc · 1,619 bytesreferences/perf-avoid-rerender.mddoc · 2,808 bytesreferences/perf-clear-on-default.mddoc · 1,617 bytesreferences/perf-debounce-search.mddoc · 3,163 bytesreferences/perf-key-isolation.mddoc · 3,024 bytesreferences/perf-serialize-utility.mddoc · 2,028 bytesreferences/perf-throttle-updates.mddoc · 2,966 bytesreferences/server-next15-async.mddoc · 2,088 bytesreferences/server-parse-before-get.mddoc · 2,163 bytesreferences/server-search-params-cache.mddoc · 3,151 bytesreferences/server-shallow-false.mddoc · 2,165 bytesreferences/server-use-transition.mddoc · 2,425 bytesreferences/setup-default-options.mddoc · 2,980 bytesreferences/setup-import-server.mddoc · 1,954 bytesreferences/setup-nextjs-version.mddoc · 1,979 bytesreferences/setup-nuqs-adapter.mddoc · 2,203 bytesreferences/setup-shared-parsers.mddoc · 2,848 bytesreferences/setup-use-client.mddoc · 1,730 bytesreferences/state-avoid-derived.mddoc · 2,209 bytesreferences/state-clear-with-null.mddoc · 1,863 bytesreferences/state-options-inheritance.mddoc · 2,210 bytesreferences/state-setter-return.mddoc · 2,757 bytesreferences/state-standard-schema.mddoc · 3,477 bytesreferences/state-use-query-states.mddoc · 2,901 bytes
Read excerpt
# 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