Community编程与开发github.com

pproenca/nuqs

用于 Next.js 和其他 React 框架的 nuqs(类型安全的 URL 查询状态)最佳实践。在编写、审查或重构使用 nuqs 进行 URL 状态管理的代码时使用。触发任务涉及 useQueryState、useQueryStates、搜索参数、URL 状态、查询参数、nuqs 解析器、limitUrlUpdates、Standard Schema、NuqsAdapter 或带有状态的 Next.js 路由。

nuqs 是什么?

此技能提供了 nuqs(一种类型安全的 URL 查询状态管理库)在 Next.js 和其他 React 框架中的最佳实践指南。它适用于编写、审查或重构涉及 URL 状态管理的代码,包括使用 useQueryState、useQueryStates、搜索参数、查询参数、nuqs 解析器、limitUrlUpdates、Standard Schema、NuqsAdapter 或与状态相关的 Next.js 路由。技能旨在确保通过 URL 进行的状态管理是类型安全的、高效的且易于维护。它支持所有使用 nuqs 的 React 框架,尤其针对 Next.js 进行了优化。通过遵循本文档中的实践,开发者可以避免常见陷阱,增强应用的可访问性和可分享性,并保持状态与 URL 同步。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pproenca/dot-skills/tree/main/skills/nuqs

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

nuqs 是做什么的?

用于 Next.js 和其他 React 框架的 nuqs(类型安全的 URL 查询状态)最佳实践。在编写、审查或重构使用 nuqs 进行 URL 状态管理的代码时使用。触发任务涉及 useQueryState、useQueryStates、搜索参数、URL 状态、查询参数、nuqs 解析器、limitUrlUpdates、Standard Schema、NuqsAdapter 或带有状态的 Next.js 路由。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

pproenca/clean-architecture

Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.

pproenca/code-simplifier

Code simplification skill for improving clarity, consistency, and maintainability while preserving exact behavior. Use when simplifying code, reducing complexity, cleaning up recent changes, applying refactoring patterns, or improving readability. Triggers on tasks involving code cleanup, simplification, refactoring, or readability improvements.

pproenca/emilkowal-animations

Emil Kowalski's animation best practices for web interfaces. Use when writing, reviewing, or implementing animations in React, CSS, or Framer Motion. Triggers on tasks involving transitions, easing, gestures, toasts, drawers, or motion.

pproenca/react-hook-form

React Hook Form performance optimization for client-side form validation using useForm, useWatch, useController, useFieldArray, and the v7.55+ subscribe() API. This skill should be used when building client-side controlled forms with React Hook Form library. This skill does NOT cover React 19 Server Actions, useActionState, or server-side form handling (use react-19 skill for those).

pproenca/typescript

TypeScript performance, tsconfig, type errors, async patterns — triggered when the user asks to "optimize TypeScript performance", "speed up tsc compilation", "configure tsconfig.json", "fix type errors", "improve async patterns", or encounters TS errors (TS2322, TS2339, "is not assignable to"). Also triggers on .ts, .tsx, .d.ts file work involving type definitions, module organization, or memory management. Does NOT cover TypeScript basics, framework-specific patterns, or testing.

pproenca/vitest

Vitest testing framework patterns for test setup, async testing, mocking with vi.*, snapshots, and test performance (formerly test-vitest). This skill should be used when writing or debugging Vitest tests. This skill does NOT cover TDD methodology (use test-tdd skill), API mocking with MSW (use test-msw skill), or Jest-specific APIs.

pproenca/zod

Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).

相关技能