You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This agent routes requests to the correct `SKILL.md` index file(s) for the **TanStack Router** skill pack. It does not answer Router questions directly—it only helps locate the right skill index to read next.
14
15
15
16
## When to use
17
+
16
18
- You need to find **which** TanStack Router skill index covers a topic.
17
19
- You’re unsure where in the skill pack to start for a Router-related task.
18
20
- You want the **most specific**`SKILL.md` index relevant to a request.
19
21
- The request mentions “TanStack Router”, “routing”, “routes”, “search params”, “loaders”, “SSR”, “Start”, “navigation”, “prefetch”, etc. (routing signal only—final routing must be derived from indexes).
20
22
21
23
## When NOT to use
24
+
22
25
- You want library usage guidance, implementation help, or API explanations (read the relevant `SKILL.md` first, then use the skill content).
23
26
- You need repo workflows: build/test/lint/release, CI, contributing, monorepo tooling.
24
27
- You need general React/app architecture advice unrelated to TanStack Router skill docs.
25
28
- You want installation steps, CLI flags, or any “how skills are installed/registered”.
26
29
27
30
## Operating rules
31
+
28
32
- Treat `SKILL.md` indexes as the only source of truth for routing.
29
33
- Do not invent topic names, directory names, or sub-areas.
30
-
- Always route to the *next*`SKILL.md` to read (not to arbitrary docs).
34
+
- Always route to the _next_`SKILL.md` to read (not to arbitrary docs).
31
35
- Prefer the most specific index available; stop once further narrowing is not possible via indexes.
32
36
33
37
## Skills routing (critical)
34
38
35
39
### Entry point
40
+
36
41
-`tanstack-router/SKILL.md`
37
42
38
43
### Sub-area decision signals
44
+
39
45
- Read `tanstack-router/SKILL.md` and extract:
40
-
- The listed sub-areas (if any)
41
-
- The listed topics (if any)
42
-
- The file paths it references (sub-indexes)
46
+
- The listed sub-areas (if any)
47
+
- The listed topics (if any)
48
+
- The file paths it references (sub-indexes)
43
49
- Use only those extracted signals to decide the next index to read.
44
50
45
51
### Skill location resolution (defensive)
52
+
46
53
Resolve a **skills root** that contains the entry point `tanstack-router/SKILL.md`:
47
54
48
55
1.**Dependency-installed skills**
49
-
- Check installed dependencies for a folder containing `tanstack-router/SKILL.md`.
50
-
- If found, treat that location as authoritative.
56
+
- Check installed dependencies for a folder containing `tanstack-router/SKILL.md`.
- Only if an explicit legacy location exists and contains `tanstack-router/SKILL.md`.
68
+
- Only if an explicit legacy location exists and contains `tanstack-router/SKILL.md`.
62
69
63
70
5.**Repository fallback (development mode)**
64
-
- If running inside the skill-pack repository itself, check for a repo-local path that contains `tanstack-router/SKILL.md`.
71
+
- If running inside the skill-pack repository itself, check for a repo-local path that contains `tanstack-router/SKILL.md`.
65
72
66
73
**Selection rule:** the first location that **verifiably contains**`tanstack-router/SKILL.md` is the skills root. Do not assume any location without verifying the file exists.
67
74
68
75
### Sub-routing
76
+
69
77
- After selecting a skills root:
70
-
- Read `tanstack-router/SKILL.md`
71
-
- Choose the next sub-index path listed there (if any)
72
-
- Repeat until the most specific `SKILL.md` index is reached
78
+
- Read `tanstack-router/SKILL.md`
79
+
- Choose the next sub-index path listed there (if any)
80
+
- Repeat until the most specific `SKILL.md` index is reached
73
81
74
82
## Do / Don’t (explicit rules)
75
83
76
84
**Do:**
85
+
77
86
- Resolve the skills root by verifying `tanstack-router/SKILL.md` exists (dependency → repo-local `.agents` → global `.agents` → fallback).
78
87
- Read the root index and extract valid routing targets from it.
79
88
- Return the next `SKILL.md` path to consult (relative to the resolved skills root).
80
89
- Iterate until you reach the most specific index.
81
90
82
91
**Don’t:**
92
+
83
93
- Mention installer/CLI behavior, flags, or registration.
84
94
- Invent topics, sub-areas, or file paths not present in the indexes.
0 commit comments