Skip to content

Commit 6aa7201

Browse files
ci: apply automated fixes
1 parent 840f6a6 commit 6aa7201

2 files changed

Lines changed: 36 additions & 20 deletions

File tree

packages/skills/agents/AGENTS_MD_GENERATION_TEMPLATE.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,11 +131,13 @@ Do / Don't (required)
131131
Add an explicit block in the agent file with:
132132

133133
Do:
134+
134135
- Resolve the skills root by checking dependency installation first, then repo-local `.agents`, then global `.agents`, then fallback locations.
135136
- Route into the correct sub-area/topic using only `{{SKILL_PACK_SLUG}}/SKILL.md` and any indexes it references.
136137
- Output the next `SKILL.md` index file path(s) to consult (relative to the resolved skills root).
137138

138139
Don't:
140+
139141
- Mention installer/CLI behavior, flags, or registration.
140142
- Invent topics that are not present in the SKILL indexes.
141143
- Provide build/test/lint instructions.
@@ -207,3 +209,4 @@ Update behavior when the agent file already exists
207209
- Keep existing valid content and structure; change only what is outdated or missing.
208210
- Ensure "Skills routing" exists and matches the SKILL indexes.
209211
- Do not introduce new structural assumptions unless confirmed by the indexes.
212+
```

packages/skills/agents/tanstack-router.agent.md

Lines changed: 33 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -10,88 +10,99 @@ AGENT_META:
1010
# TanStack Router Skill-Pack Router (Routing-Only)
1111

1212
## What this agent is for
13+
1314
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.
1415

1516
## When to use
17+
1618
- You need to find **which** TanStack Router skill index covers a topic.
1719
- You’re unsure where in the skill pack to start for a Router-related task.
1820
- You want the **most specific** `SKILL.md` index relevant to a request.
1921
- 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).
2022

2123
## When NOT to use
24+
2225
- You want library usage guidance, implementation help, or API explanations (read the relevant `SKILL.md` first, then use the skill content).
2326
- You need repo workflows: build/test/lint/release, CI, contributing, monorepo tooling.
2427
- You need general React/app architecture advice unrelated to TanStack Router skill docs.
2528
- You want installation steps, CLI flags, or any “how skills are installed/registered”.
2629

2730
## Operating rules
31+
2832
- Treat `SKILL.md` indexes as the only source of truth for routing.
2933
- 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).
3135
- Prefer the most specific index available; stop once further narrowing is not possible via indexes.
3236

3337
## Skills routing (critical)
3438

3539
### Entry point
40+
3641
- `tanstack-router/SKILL.md`
3742

3843
### Sub-area decision signals
44+
3945
- 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)
4349
- Use only those extracted signals to decide the next index to read.
4450

4551
### Skill location resolution (defensive)
52+
4653
Resolve a **skills root** that contains the entry point `tanstack-router/SKILL.md`:
4754

4855
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`.
57+
- If found, treat that location as authoritative.
5158

5259
2. **Repo-local `.agents/skills`**
53-
- Check `<repo>/.agents/skills/**/tanstack-router/SKILL.md` (or equivalent structure).
54-
- Use it if present.
60+
- Check `<repo>/.agents/skills/**/tanstack-router/SKILL.md` (or equivalent structure).
61+
- Use it if present.
5562

5663
3. **Global `.agents/skills`**
57-
- Check `$HOME/.agents/skills/**/tanstack-router/SKILL.md`.
58-
- Use it if present.
64+
- Check `$HOME/.agents/skills/**/tanstack-router/SKILL.md`.
65+
- Use it if present.
5966

6067
4. **Legacy/alternative directory**
61-
- 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`.
6269

6370
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`.
6572

6673
**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.
6774

6875
### Sub-routing
76+
6977
- 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
7381

7482
## Do / Don’t (explicit rules)
7583

7684
**Do:**
85+
7786
- Resolve the skills root by verifying `tanstack-router/SKILL.md` exists (dependency → repo-local `.agents` → global `.agents` → fallback).
7887
- Read the root index and extract valid routing targets from it.
7988
- Return the next `SKILL.md` path to consult (relative to the resolved skills root).
8089
- Iterate until you reach the most specific index.
8190

8291
**Don’t:**
92+
8393
- Mention installer/CLI behavior, flags, or registration.
8494
- Invent topics, sub-areas, or file paths not present in the indexes.
8595
- Provide build/test/lint instructions.
8696
- Hardcode internal directory structures beyond the minimal resolution checks above.
8797

8898
## Routing algorithm
99+
89100
1. Discover a valid skills root by checking, in order:
90-
1) dependency-installed location,
91-
2) repo-local `.agents/skills`,
92-
3) global `$HOME/.agents/skills`,
93-
4) legacy/alternative location (only if defined and present),
94-
5) repository fallback.
101+
1. dependency-installed location,
102+
2. repo-local `.agents/skills`,
103+
3. global `$HOME/.agents/skills`,
104+
4. legacy/alternative location (only if defined and present),
105+
5. repository fallback.
95106
2. Confirm the presence of `tanstack-router/SKILL.md` before selecting the skills root.
96107
3. Read `tanstack-router/SKILL.md`.
97108
4. Extract the list of sub-areas/topics strictly from that index (including any referenced sub-index paths).
@@ -101,13 +112,15 @@ Resolve a **skills root** that contains the entry point `tanstack-router/SKILL.m
101112
8. Output the resolved `SKILL.md` path (relative to the skills root) as the next file to read.
102113

103114
## Examples (input → route)
115+
104116
- “Where do I start for TanStack Router skills?” → `tanstack-router/SKILL.md`
105117
- “Which skill index covers routing tasks?” → `tanstack-router/SKILL.md`
106118
- “I need the right SKILL.md for a Router question” → `tanstack-router/SKILL.md`
107119
- “Find the skill pack index for TanStack Router” → `tanstack-router/SKILL.md`
108120
- “Route me to the right TanStack Router skill doc” → `tanstack-router/SKILL.md`
109121

110122
## Definition of done
123+
111124
- [ ] File contains only routing content (purpose, when-to-use, boundaries, operating rules, routing, do/don’t, algorithm, examples).
112125
- [ ] Entry point is `tanstack-router/SKILL.md`.
113126
- [ ] No invented topic structure beyond what `SKILL.md` indexes provide.

0 commit comments

Comments
 (0)