mcpField
N
nuqs

nuqs

github.com/fandhe-ai開発4100 回インストール4 日前に更新
リポジトリ

nuqs について

nuqsのリファレンススキルです。nuqsはURLクエリパラメーターと状態を同期する、React.useStateの型安全な代替となるReactライブラリです。タスクに応じてドキュメントの分類を案内し、関連APIの確認を支援します。

主な機能

  1. 01タスクに応じたドキュメント分類
  2. 02フックとパーサーのリファレンス
  3. 03フレームワークアダプターの案内
  4. 04オプションとサーバーAPIのリファレンス
  5. 05制限・サンプル・スクリプトの案内

活用シーン

  1. 01useQueryStateやuseQueryStatesの確認
  2. 02組み込みまたはカスタムパーサーの選択
  3. 03Reactフレームワーク向けアダプターの設定
  4. 04URL制限やサーバー側解析の情報確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fandhe-ai/agent-reference-skills --skill nuqs

インストール後、Claude Code で/nuqsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/adapters/
adapters.md
README.md
references/guides/
README.md
seo.md
tips-tricks.md
troubleshooting.md
references/hooks/
README.md
useQueryState.md
useQueryStates.md
references/limits/
limits.md
README.md
references/options/
options.md
README.md
references/parsers/
built-in.md
community-effect-schema.md
community-sury.md
community-tanstack-table.md
community-zod-codecs.md
custom.md
README.md
references/server/
README.md
server-side.md
references/utilities/
createSerializer.md
createStandardSchemaV1.md
inferParserType.md
README.md
samples/
adapter-setup.md
array-params.md
basic-query-state.md
custom-parser.md

詳細

プロジェクトの README より

nuqs API リファレンス

nuqs — Type-safe URL query state management for React。 React.useState のドロップイン置換として URL クエリパラメータと状態を同期する。

対象 nuqs v2.10.2（2026-10-08、GitHub tag v2.10.2、docs 原本 packages/docs/content/docs at that tag）。

ディレクトリ構成

skills/nuqs/
  SKILL.md
  references/
    hooks/
      README.md
      useQueryState.md
      useQueryStates.md
    parsers/
      README.md
      built-in.md
      custom.md
      community-zod-codecs.md
      community-effect-schema.md
      community-sury.md
      community-tanstack-table.md
    adapters/
      README.md
      adapters.md
    guides/
      README.md
      troubleshooting.md
      seo.md
      tips-tricks.md
    options/
      README.md
      options.md
    server/
      README.md
      server-side.md
    utilities/
      README.md
      createSerializer.md
      createStandardSchemaV1.md
      inferParserType.md
    limits/
      README.md
      limits.md
  samples/
    README.md
    basic-query-state.md
    typed-state-with-parsers.md
    multiple-params-batch-update.md
    search-filter-debounce.md
    server-side-parsing.md
    search-params-cache.md
    adapter-setup.md
    custom-parser.md
    url-key-remapping.md
    array-params.md
    testing.md
    suspense-boundary.md
    seo-canonical-url.md
  scripts/
    README.md
    install.md
    setup.md
    testing.md
    debug.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

  1. 下記マッピング表でタスクに対応するカテゴリを探す
  2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
  3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスクカテゴリ参照 README
useQueryState の基本的な使い方、単一パラメータの読み書きhooksreferences/hooks/README.md
useQueryStates でバッチ更新、複数パラメータの同期hooksreferences/hooks/README.md
ビルトインパーサー（parseAsString / parseAsInteger / parseAsBoolean / parseAsArrayOf 等）の使い方parsersreferences/parsers/README.md
createParser でカスタムパーサーを作成する、Zod codecs / Effect Schema / Sury / TanStack Table コミュニティパーサーparsersreferences/parsers/README.md
フレームワーク別 NuqsAdapter（Next.js app/pages/unified、React SPA、Remix、React Router v6/v7/v8、TanStack Router）、serverSearch、非推奨 adapteradaptersreferences/adapters/README.md
Suspense boundary エラー、同一 key の異なるパーサー、Pages Router SSR の null、canonical URL / SEO、カスタムフック再利用guidesreferences/guides/README.md
history, shallow, scroll, throttle, debounce, clearOnDefault, startTransition オプション設定optionsreferences/options/README.md
createLoader, createSearchParamsCache でサーバーサイド解析serverreferences/server/README.md
createSerializer, createStandardSchemaV1, inferParserType でパーサーからユーティリティを生成するutilitiesreferences/utilities/README.md
URL 長さ・ブラウザ制限（throttling, max URL length）を知りたいlimitsreferences/limits/README.md
典型的な使い方を知りたいsamplessamples/README.md
インストール・CLI コマンド・テスト・デバッグ手順を知りたいscriptsscripts/README.md

コメント

Markdown 対応