免费在 GitHub 公开

nuqs

Type-safe URL query state management with nuqs 2.x. Use when writing or reviewing code that uses useQueryState, useQueryStates, URL search params, query parameters, nuqs parsers, createLoader, createSearchParamsCache, createSerializer, or URL state in Next.js, React, Remix, React Router, or TanStack Router.

中文简介正在准备中。当前显示原文说明。

fellipeutaka/website

查看安装方法

包含的文件（43）

SKILL.md5.6 KB
references/advanced-adapter-props.md1.9 KB
references/advanced-eq-function.md1.5 KB
references/advanced-optimistic-search-params.md1.2 KB
references/advanced-standard-schema.md2.7 KB
references/advanced-url-keys.md1.5 KB
references/debug-common-errors.md1.8 KB
references/debug-enable-logging.md911 B
references/debug-testing.md3.1 KB
references/history-back-sync.md1.3 KB
references/history-push-navigation.md1.3 KB
references/history-replace-ephemeral.md1.3 KB
references/history-scroll-behavior.md1.3 KB
references/parser-array-format.md1.7 KB
references/parser-custom.md2.1 KB
references/parser-date-format.md1.8 KB
references/parser-enum-literals.md2.0 KB
references/parser-hex-colors.md691 B
references/parser-index-offset.md1.6 KB
references/parser-json-validation.md1.8 KB
references/parser-typed.md2.0 KB
references/parser-with-default.md1.6 KB
references/perf-avoid-rerender.md1.3 KB
references/perf-clear-on-default.md1.4 KB
references/perf-limit-url-updates.md2.6 KB
references/perf-serialize-utility.md1.8 KB
references/server-create-loader.md3.0 KB
references/server-next15-async.md1.8 KB
references/server-search-params-cache.md2.6 KB
references/server-shallow-false.md1.4 KB
references/server-share-parsers.md1.6 KB
references/server-use-transition.md1.6 KB
references/setup-adapter.md3.0 KB
references/setup-client-hooks.md1.7 KB
references/setup-server-imports.md1.6 KB
references/setup-shared-parsers.md1.9 KB
references/state-avoid-derived.md1.8 KB
references/state-clear-with-null.md1.2 KB
references/state-controlled-inputs.md1.3 KB
references/state-functional-updates.md1.4 KB
references/state-options-inheritance.md1.5 KB
references/state-setter-return.md1.1 KB
references/state-use-query-states.md2.0 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

nuqs Best Practices

Type-safe URL query state management with nuqs 2.x. Contains rules across 8 categories, prioritized by impact.

Rule Categories

Priority	Category	Impact	Prefix
1	Parser Configuration	CRITICAL	`parser-`
2	Adapter & Setup	CRITICAL	`setup-`
3	State Management	HIGH	`state-`
4	Server Integration	HIGH	`server-`
5	Performance	MEDIUM	`perf-`
6	History & Navigation	MEDIUM	`history-`
7	Debugging & Testing	LOW-MEDIUM	`debug-`
8	Advanced Patterns	LOW	`advanced-`

Quick Reference

1. Parser Configuration (CRITICAL)

parser-typed — Use typed parsers for non-string values
parser-with-default — Use withDefault for non-nullable state
parser-enum-literals — Use literal/enum parsers for constrained values
parser-array-format — Choose correct array parser format
parser-json-validation — Validate JSON parser with Standard Schema
parser-date-format — Select appropriate date parser
parser-index-offset — Use parseAsIndex for 1-based URL display
parser-hex-colors — Use parseAsHex for color values
parser-custom — Create custom parsers for complex types

2. Adapter & Setup (CRITICAL)

setup-adapter — Wrap app with correct NuqsAdapter
setup-client-hooks — Add 'use client' for hooks
setup-server-imports — Import server utilities from nuqs/server
setup-shared-parsers — Define shared parsers in a dedicated file

3. State Management (HIGH)

state-use-query-states — Use useQueryStates for related parameters
state-functional-updates — Use functional updates for derived state
state-clear-with-null — Clear URL parameters with null
state-controlled-inputs — Handle controlled input value properly
state-avoid-derived — Avoid derived state from URL parameters
state-options-inheritance — Use withOptions for parser-level config
state-setter-return — Use setter return value for URL access

4. Server Integration (HIGH)

server-create-loader — Use createLoader for page-level server parsing
server-search-params-cache — Use createSearchParamsCache for nested RSC access
server-shallow-false — Use shallow:false to trigger server re-renders
server-use-transition — Integrate useTransition for loading states
server-share-parsers — Share parsers between client and server
server-next15-async — Handle async searchParams in Next.js 15+

5. Performance (MEDIUM)

perf-limit-url-updates — Throttle/debounce URL updates
perf-clear-on-default — Use clearOnDefault for clean URLs
perf-avoid-rerender — Memoize components using URL state
perf-serialize-utility — Use createSerializer for link URLs

6. History & Navigation (MEDIUM)

history-push-navigation — Use history:push for navigation-like state
history-replace-ephemeral — Use history:replace for ephemeral state
history-scroll-behavior — Control scroll behavior on URL changes
history-back-sync — Handle browser back/forward navigation

7. Debugging & Testing (LOW-MEDIUM)

debug-enable-logging — Enable debug logging for troubleshooting
debug-common-errors — Diagnose common nuqs errors
debug-testing — Test components and hooks with URL state

8. Advanced Patterns (LOW)

advanced-url-keys — Use urlKeys for shorter URL param names
advanced-eq-function — Implement eq function for object parsers
advanced-adapter-props — Configure NuqsAdapter global defaults and URL middleware
advanced-standard-schema — Use createStandardSchemaV1 and inferParserType
advanced-optimistic-search-params — useOptimisticSearchParams for Remix/React Router

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

agent-browser

免费

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

中文简介正在准备中。当前显示原文说明。