Skip to content

Commit ed23460

Browse files
Sheraffclaude
andcommitted
docs(skills): reference cross-package skills by intent ID
@tanstack/intent 0.5.4 rejects SKILL.md links that resolve outside the owning package, which fails the "Validate intent skills" CI job. Replace those relative links with `<package>#<skill>` identifiers that `intent load` resolves regardless of node_modules layout. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent e66da18 commit ed23460

16 files changed

Lines changed: 48 additions & 35 deletions

File tree

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
'@tanstack/react-start': patch
3+
'@tanstack/router-core': patch
4+
'@tanstack/router-plugin': patch
5+
'@tanstack/solid-router': patch
6+
'@tanstack/solid-start': patch
7+
'@tanstack/start-client-core': patch
8+
'@tanstack/start-server-core': patch
9+
'@tanstack/vue-router': patch
10+
'@tanstack/vue-start': patch
11+
---
12+
13+
Reference agent skills in other packages by their `intent load` identifier (`@tanstack/<package>#<skill>`) instead of relative file links that break once packages are installed.

‎packages/react-router/skills/compositions/router-query/SKILL.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ sources:
2121

2222
# TanStack Router + TanStack Query Integration
2323

24-
This skill requires familiarity with both TanStack Router and TanStack Query. Read [router-core](../../../../router-core/skills/router-core/SKILL.md) and [react-router](../../react-router/SKILL.md) first.
24+
This skill requires familiarity with both TanStack Router and TanStack Query. Read `@tanstack/router-core#router-core` and [react-router](../../react-router/SKILL.md) first.
2525

2626
This skill covers coordinating TanStack Query as an external data cache with TanStack Router's loader system. The router acts as a **coordinator** — it triggers data fetching during navigation, while Query manages caching, background refetching, and data lifecycle.
2727

@@ -437,5 +437,5 @@ TanStack Router has its own SWR cache (`staleTime`, `gcTime`, `defaultPreloadSta
437437

438438
## Cross-References
439439

440-
- [router-core/data-loading](../../../../router-core/skills/router-core/data-loading/SKILL.md) — built-in loader caching fundamentals
441-
- [router-core/ssr](../../../../router-core/skills/router-core/ssr/SKILL.md) — SSR setup for dehydration/hydration
440+
- `@tanstack/router-core#router-core/data-loading` — built-in loader caching fundamentals
441+
- `@tanstack/router-core#router-core/ssr` — SSR setup for dehydration/hydration

‎packages/react-router/skills/react-router/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ sources:
2323

2424
# React Router (`@tanstack/react-router`)
2525

26-
This skill builds on router-core. Read [router-core](../../../router-core/skills/router-core/SKILL.md) first for foundational concepts.
26+
This skill builds on router-core. Read `@tanstack/router-core#router-core` first for foundational concepts.
2727

2828
> **CRITICAL**: TanStack Router types are FULLY INFERRED. Never cast, never annotate inferred values.
2929
> **CRITICAL**: TanStack Router is CLIENT-FIRST. Loaders run on the client by default, not on the server.
@@ -495,4 +495,4 @@ function App() {
495495

496496
## Cross-References
497497

498-
- [router-core/SKILL.md](../../../router-core/skills/router-core/SKILL.md) — all sub-skills for domain-specific patterns (search params, data loading, navigation, auth, SSR, etc.)
498+
- `@tanstack/router-core#router-core` — all sub-skills for domain-specific patterns (search params, data loading, navigation, auth, SSR, etc.)

‎packages/react-start/skills/lifecycle/migrate-from-nextjs/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -432,5 +432,5 @@ export const myAction = createServerFn({ method: 'POST' })
432432
## Cross-References
433433

434434
- [react-start](../../react-start/SKILL.md) — full React Start setup
435-
- [start-core/server-functions](../../../../start-client-core/skills/start-core/server-functions/SKILL.md) — server function patterns
436-
- [start-core/execution-model](../../../../start-client-core/skills/start-core/execution-model/SKILL.md) — isomorphic execution
435+
- `@tanstack/start-client-core#start-core/server-functions` — server function patterns
436+
- `@tanstack/start-client-core#start-core/execution-model` — isomorphic execution

‎packages/react-start/skills/react-start/SKILL.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -291,6 +291,6 @@ Without `<Scripts />` in the root route's `<body>`, client JavaScript doesn't lo
291291

292292
## Cross-References
293293

294-
- [start-core](../../../start-client-core/skills/start-core/SKILL.md) — core Start concepts
295-
- [router-core](../../../router-core/skills/router-core/SKILL.md) — routing fundamentals
296-
- [react-router](../../../react-router/skills/react-router/SKILL.md) — React Router hooks and components
294+
- `@tanstack/start-client-core#start-core` — core Start concepts
295+
- `@tanstack/router-core#router-core` — routing fundamentals
296+
- `@tanstack/react-router#react-router` — React Router hooks and components

‎packages/router-core/skills/router-core/auth-and-guards/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ sources:
2121

2222
# Auth and Guards
2323

24-
> **This skill covers the routing side of auth.** Route guards are UX and navigation control; the data/API boundary still belongs in the server function, server route, or API endpoint that reads or mutates private data. For the **server-side primitives** — session cookies (`HttpOnly`/`Secure`/`SameSite`), `useSession`-style helpers, OAuth `state` + PKCE, password-reset enumeration defense, CSRF, rate limiting — see [start-core/auth-server-primitives](../../../../start-client-core/skills/start-core/auth-server-primitives/SKILL.md).
24+
> **This skill covers the routing side of auth.** Route guards are UX and navigation control; the data/API boundary still belongs in the server function, server route, or API endpoint that reads or mutates private data. For the **server-side primitives** — session cookies (`HttpOnly`/`Secure`/`SameSite`), `useSession`-style helpers, OAuth `state` + PKCE, password-reset enumeration defense, CSRF, rate limiting — see `@tanstack/start-client-core#start-core/auth-server-primitives`.
2525
>
2626
> **CRITICAL**: A route guard (`beforeLoad`) does NOT protect a `createServerFn` declared on that route. Server functions are API endpoints reachable independently of the route that calls them. See "Route guards do not protect server functions" below.
2727
@@ -408,7 +408,7 @@ const getMyOrders = createServerFn({ method: 'GET' })
408408
})
409409
```
410410

411-
Rule of thumb: every `createServerFn`, server route, or API endpoint that touches user data needs `authMiddleware` (or an equivalent in-handler check). The route guard is for the page experience; the endpoint guard is for the data. See [start-core/auth-server-primitives](../../../../start-client-core/skills/start-core/auth-server-primitives/SKILL.md) for the full session/middleware pattern.
411+
Rule of thumb: every `createServerFn`, server route, or API endpoint that touches user data needs `authMiddleware` (or an equivalent in-handler check). The route guard is for the page experience; the endpoint guard is for the data. See `@tanstack/start-client-core#start-core/auth-server-primitives` for the full session/middleware pattern.
412412

413413
### CRITICAL: The anonymous destination can still disclose protected data
414414

‎packages/router-core/skills/router-core/ssr/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -489,4 +489,4 @@ See [router-core/data-loading](../data-loading/SKILL.md) for loader fundamentals
489489
## Cross-References
490490

491491
- [router-core/data-loading](../data-loading/SKILL.md) — SSR changes where loaders execute
492-
- [compositions/router-query](../../../../react-router/skills/compositions/router-query/SKILL.md) — SSR dehydration/hydration with TanStack Query
492+
- `@tanstack/react-router#compositions/router-query` — SSR dehydration/hydration with TanStack Query

‎packages/router-plugin/skills/router-plugin/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -246,5 +246,5 @@ Changes to `routeTree.gen.ts` are overwritten and can leave source routes, gener
246246

247247
## Cross-References
248248

249-
- [router-core/code-splitting](../../../router-core/skills/router-core/code-splitting/SKILL.md) — manual code splitting concepts
250-
- [virtual-file-routes](../../../virtual-file-routes/skills/virtual-file-routes/SKILL.md) — programmatic route trees
249+
- `@tanstack/router-core#router-core/code-splitting` — manual code splitting concepts
250+
- `@tanstack/virtual-file-routes#virtual-file-routes` — programmatic route trees

‎packages/solid-router/skills/solid-router/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ sources:
2121

2222
# Solid Router (`@tanstack/solid-router`)
2323

24-
This skill builds on router-core. Read [router-core](../../../router-core/skills/router-core/SKILL.md) first for foundational concepts.
24+
This skill builds on router-core. Read `@tanstack/router-core#router-core` first for foundational concepts.
2525

2626
> **CRITICAL**: TanStack Router types are FULLY INFERRED. Never cast, never annotate inferred values.
2727
> **CRITICAL**: TanStack Router is CLIENT-FIRST. Loaders run on the client by default, not on the server.
@@ -495,4 +495,4 @@ Must set `target: 'solid'` in the router plugin config. Default is `'react'`.
495495

496496
## Cross-References
497497

498-
- [router-core/SKILL.md](../../../router-core/skills/router-core/SKILL.md) — all sub-skills for domain-specific patterns (search params, data loading, navigation, auth, SSR, etc.)
498+
- `@tanstack/router-core#router-core` — all sub-skills for domain-specific patterns (search params, data loading, navigation, auth, SSR, etc.)

‎packages/solid-start/skills/solid-start/SKILL.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ sources:
1919

2020
# Solid Start (`@tanstack/solid-start`)
2121

22-
This skill builds on start-core. Read [start-core](../../../start-client-core/skills/start-core/SKILL.md) first for foundational concepts.
22+
This skill builds on start-core. Read `@tanstack/start-client-core#start-core` first for foundational concepts.
2323

2424
This skill covers the Solid-specific bindings, setup, and patterns for TanStack Start.
2525

@@ -276,6 +276,6 @@ plugins: [tanstackStart(), solidPlugin()]
276276

277277
## Cross-References
278278

279-
- [start-core](../../../start-client-core/skills/start-core/SKILL.md) — core Start concepts
280-
- [router-core](../../../router-core/skills/router-core/SKILL.md) — routing fundamentals
281-
- [solid-router](../../../solid-router/skills/solid-router/SKILL.md) — Solid Router hooks and components
279+
- `@tanstack/start-client-core#start-core` — core Start concepts
280+
- `@tanstack/router-core#router-core` — routing fundamentals
281+
- `@tanstack/solid-router#solid-router` — Solid Router hooks and components

0 commit comments

Comments
 (0)