pproenca/nuqs

Melhores práticas para o nuqs (estado de consulta de URL com type safety) no Next.js e outros frameworks React. Útil ao escrever, revisar ou refatorar código que utilize useQueryState, useQueryStates, parâmetros de busca, estado de URL, parsers nuqs, limitUrlUpdates, Standard Schema, NuqsAdapter ou roteamento Next.js com estado.

O que é nuqs?

Esta skill fornece diretrizes especializadas para o uso do nuqs, uma biblioteca que gerencia estado de consulta de URL de forma tipada e segura em aplicações React, especialmente Next.js. Ao ativar-se automaticamente em tarefas que envolvem hooks como useQueryState e useQueryStates, parsers personalizados, limites de atualizações de URL (limitUrlUpdates), integração com Standard Schema e o adaptador NuqsAdapter, ela ajuda desenvolvedores a evitar erros comuns e seguir as melhores práticas. O objetivo é garantir que o estado da URL seja manipulado de forma consistente, eficiente e com total suporte a TypeScript, melhorando a manutenibilidade e a experiência do usuário. A skill é útil tanto para escrita de novo código quanto para revisão ou refatoração de código existente que lida com parâmetros de busca e roteamento baseado em estado no Next.js e outros frameworks React.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que nuqs faz?

nuqs (estado de consulta de URL com type safety): melhores práticas para Next.js e outros frameworks React. Esta skill deve ser usada ao escrever, revisar ou refatorar código que utiliza nuqs para gerenciamento de estado de URL. É acionada em tarefas que envolvem useQueryState, useQueryStates, parâmetros de busca, estado de URL, parâmetros de consulta, parsers do nuqs, limitUrlUpdates, Standard Schema, NuqsAdapter ou roteamento Next.js com estado.

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).

Habilidades Relacionadas