add more skills for router

Author: LadyBluenotes

packages/router-skills/manifest.json

@@ -8,20 +8,28 @@
         "skills/v1/error-boundaries.md",
         "skills/v1/file-based-routing.md",
         "skills/v1/index.md",
+        "skills/v1/invalidation.md",
         "skills/v1/layouts.md",
         "skills/v1/links.md",
         "skills/v1/loaders.md",
+        "skills/v1/navigate-options.md",
         "skills/v1/navigation.md",
         "skills/v1/not-found-boundaries.md",
         "skills/v1/params.md",
+        "skills/v1/pending-ui.md",
         "skills/v1/prefetching.md",
+        "skills/v1/redirects.md",
         "skills/v1/route-context.md",
         "skills/v1/route-ids.md",
+        "skills/v1/route-masking.md",
         "skills/v1/route-trees.md",
+        "skills/v1/router-provider.md",
         "skills/v1/router-state.md",
         "skills/v1/search-defaults.md",
         "skills/v1/search-validation.md",
-        "skills/v1/ssr-loaders.md"
+        "skills/v1/ssr-loaders.md",
+        "skills/v1/use-match.md",
+        "skills/v1/use-search.md"
       ]
     }
   }

packages/router-skills/skills/topics.json

@@ -16,5 +16,12 @@
   "navigation.md",
   "router-state.md",
   "ssr-loaders.md",
-  "ssr-loaders.md"
+  "use-match.md",
+  "use-search.md",
+  "redirects.md",
+  "route-masking.md",
+  "router-provider.md",
+  "pending-ui.md",
+  "invalidation.md",
+  "navigate-options.md"
 ]

packages/router-skills/skills/v1/index.md

@@ -38,6 +38,14 @@ How to pick a skill:
 - Navigating programmatically after a submit or action -> `@skills/router/navigation`
 - Showing pending UI or transition state -> `@skills/router/router-state`
 - Ensuring loader data is serializable for SSR -> `@skills/router/ssr-loaders`
+- Reading a route match or match metadata -> `@skills/router/use-match`
+- Reading validated search params -> `@skills/router/use-search`
+- Redirecting from loaders/actions -> `@skills/router/redirects`
+- Presenting friendly URLs for internal routes -> `@skills/router/route-masking`
+- Wiring the router into your app root -> `@skills/router/router-provider`
+- Showing pending UI during navigation -> `@skills/router/pending-ui`
+- Revalidating data after mutations -> `@skills/router/invalidation`
+- Using replace/state/hash when navigating -> `@skills/router/navigate-options`
 
 Next:
 

packages/router-skills/skills/v1/redirects.md

@@ -0,0 +1,33 @@
+---
+id: redirects
+title: Redirects
+versions:
+  - latest
+  - ">=1 <2"
+summary: Redirect from loaders or actions.
+resources:
+  - https://tanstack.com/router/latest/docs/guide/redirects
+  - https://tanstack.com/router/latest/docs/api/router/redirect
+---
+
+# Redirects
+
+Purpose:
+
+- Redirect from loaders or actions.
+
+Scope:
+
+- Use when gating routes or handling auth flows.
+
+Guidelines:
+
+- Redirect early in loaders to avoid flashes.
+- Preserve intent with `search` or `hash`.
+- Avoid redirect loops.
+
+Example:
+
+```ts
+throw redirect({ to: "/login" })
+```

packages/router-skills/skills/v1/route-masking.md

@@ -0,0 +1,36 @@
+---
+id: route-masking
+title: Route Masking
+versions:
+  - latest
+  - ">=1 <2"
+summary: Present friendly URLs without changing route structure.
+resources:
+  - https://tanstack.com/router/latest/docs/guide/route-masking
+---
+
+# Route Masking
+
+Purpose:
+
+- Present friendly URLs without changing route structure.
+
+Scope:
+
+- Use when exposing public paths for internal routes.
+
+Guidelines:
+
+- Define masks for user-friendly URLs.
+- Keep masks aligned with params and search.
+- Document masks to avoid confusion.
+
+Example:
+
+```ts
+const route = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "projects/$projectId",
+  mask: "/p/$projectId",
+})
+```

packages/router-skills/skills/v1/router-provider.md

@@ -0,0 +1,34 @@
+---
+id: router-provider
+title: Router Provider
+versions:
+  - latest
+  - ">=1 <2"
+summary: Register the router with your app entrypoint.
+resources:
+  - https://tanstack.com/router/latest/docs/guide/installation
+  - https://tanstack.com/router/latest/docs/api/router/router-provider
+---
+
+# Router Provider
+
+Purpose:
+
+- Register the router with your app entrypoint.
+
+Scope:
+
+- Use when wiring the router into React, Solid, or Vue roots.
+
+Guidelines:
+
+- Create the router once at startup.
+- Provide route context dependencies at creation.
+- Keep provider near the root layout.
+
+Example:
+
+```tsx
+const router = createRouter({ routeTree })
+<RouterProvider router={router} />
+```

packages/router-skills/skills/v1/use-match.md

@@ -0,0 +1,33 @@
+---
+id: use-match
+title: useMatch
+versions:
+  - latest
+  - ">=1 <2"
+summary: Read the active route match and its params.
+resources:
+  - https://tanstack.com/router/latest/docs/guide/matching
+  - https://tanstack.com/router/latest/docs/api/router/use-match
+---
+
+# useMatch
+
+Purpose:
+
+- Read the active route match and params.
+
+Scope:
+
+- Use when you need route metadata for the current match.
+
+Guidelines:
+
+- Match by route ID or path.
+- Use matches to derive UI state.
+- Avoid matching inside render loops.
+
+Example:
+
+```ts
+const match = useMatch({ from: "projects/$projectId" })
+```

packages/router-skills/skills/v1/use-search.md

@@ -0,0 +1,33 @@
+---
+id: use-search
+title: useSearch
+versions:
+  - latest
+  - ">=1 <2"
+summary: Read typed search params for a route.
+resources:
+  - https://tanstack.com/router/latest/docs/guide/search-params
+  - https://tanstack.com/router/latest/docs/api/router/use-search
+---
+
+# useSearch
+
+Purpose:
+
+- Read typed search params for a route.
+
+Scope:
+
+- Use when consuming validated search state.
+
+Guidelines:
+
+- Pair with `validateSearch` schemas.
+- Prefer route-scoped search reads.
+- Keep search state serializable.
+
+Example:
+
+```ts
+const search = route.useSearch()
+```