Skip to main content
skill CX Codex

url-state-patterns — Claude Code skill: URL state patterns

The url-state-patterns Claude Code skill keeps React state in sync with URL query parameters using nuqs. It activates for shareable filters, search, and dialogs opened through a link.

no license 110 installs ★ 23 updated 2026-06-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add andrelandgraf/fullstackrecipes --skill url-state-patterns -a claude-code
Open on GitHub

What url-state-patterns does

The skill shows how to put React component state into query parameters with nuqs. For search and filters, it replaces useState with useQueryState and parsers for strings, booleans, and arrays. Setting a value to null removes its parameter; .withDefault() supplies a fallback without adding it to the URL.

Components that use useSearchParams need a Suspense boundary. The skill wraps an internal client component so consumers can use the public component directly. It applies the same structure to dialogs controlled by a URL parameter, whose state survives browser back and forward navigation. Complete the URL State with nuqs recipe first, and use the nuqs library.

What it helps with

  • keep a search field in sync with the URL
  • store filters in query parameters
  • remove cleared values from the address
  • open a dialog from a shared link

Example prompts for the agent

  • Connect the React search field to a URL parameter with nuqs.
  • Add tag and archived-item filters whose state lives in the URL.
  • Build a delete dialog that opens from a link and closes on browser back.

How to install url-state-patterns

1Skills CLI (Vercel)

npx skills add andrelandgraf/fullstackrecipes --skill url-state-patterns -a claude-code

2Manually: put the files in place

~/.claude/skills/url-state-patterns/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/url-state-patterns/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about url-state-patterns

How do I install url-state-patterns in Claude Code?

Run npx skills add andrelandgraf/fullstackrecipes --skill url-state-patterns -a claude-code. The skill file is at ~/.claude/skills/url-state-patterns/SKILL.md.

What does url-state-patterns do?

It provides patterns for tying React state to URL query parameters with nuqs, including search, filters, and link-addressable dialogs.

What does url-state-patterns require?

Use the nuqs library and complete the URL State with nuqs recipe first.

Similar skills

All skills for Frontend and UI →

From the same set9

ralph-loop-workflow The ralph-loop-workflow skill runs an agent through a coding loop that turns a broad goal into tasks, changes code, and checks the result. Use it for work that needs repeated agent-led iterations. CX Codex +1 684installs use-fullstackrecipes use-fullstackrecipes — a skill for discovering and applying fullstackrecipes: setup guides for tools and day-to-day patterns for databases and APIs. The agent fetches the needed .md from the site and follows its instructions. CX Codex +1 240installs testing-best-practices testing-best-practices — a skill that teaches the agent to pick the right test type (Playwright, integration, or unit) and run it against an isolated Neon branch that auto-deletes after an hour. CX Codex +1 113installs logging-best-practices logging-best-practices teaches the agent to write structured Pino logs: context-first signature, levels for different scenarios, workflow-safe wrapper. CX Codex +1 111installs authentication-best-practices The authentication-best-practices Claude Code skill covers Better Auth sessions, route protection, and sign-in flows. It activates when a task involves access control for pages or APIs. CX Codex +1 106installs sentry-best-practices The sentry-best-practices Claude Code skill guides Sentry error capture, context, tracing, and logging in application code. It activates during work on error handling or performance instrumentation. CX Codex +1 106installs workflow-best-practices The workflow-best-practices Claude Code skill covers durable workflows with steps, streaming, and agent runs. It applies when creating, starting, resuming, or saving a workflow. CX Codex +1 104installs drizzle-queries The drizzle-queries Claude Code skill guides type-safe Postgres queries with Drizzle ORM. It activates for database reads, mutations, and new table work. CX Codex +1 103installs

Project sponsors

Companies that keep this analytics open