nuqs Codemod Runner

Migrate a codebase from pre-v2.5 nuqs patterns to current v2.5–v2.8 idioms. The skill is read-only by default — it never modifies files without an explicit confirmation step, and refuses to run on a dirty git working tree.

When to Apply

Trigger this skill when:

• A user asks to "upgrade nuqs" or "migrate to nuqs 2.x" in a project that already uses nuqs
• You spot any of the 5 legacy patterns during a review (see the codemod table below)
• A nuqs version bump in package.json from <2.5 to >=2.5 is part of the diff
• The user has just installed/updated the nuqs skill and wants to bring existing code into line with it

This skill is the automation companion to skills/.curated/nuqs/ — that skill teaches what each correct pattern looks like; this skill rewrites legacy code to match.

Workflow Overview