|
1 | 1 | --- |
2 | | -title: "From Docs to Agents: Shipping Knowledge That Travels With Your Package" |
| 2 | +title: 'From Docs to Agents: Shipping Knowledge That Travels With Your Package' |
3 | 3 | published: 2026-03-04 |
4 | 4 | authors: |
5 | 5 | - Sarah Gerrard |
6 | | - - Kyle Matthews |
| 6 | + - Kyle Matthews |
7 | 7 | --- |
8 | 8 |
|
9 | 9 |  |
10 | 10 |
|
11 | 11 | Your docs are good. Your types are solid. Your agent still gets it wrong. |
12 | 12 |
|
13 | | -Not because it's dumb — because there's no pipeline between what you know about your tool and what agents know about your tool. Docs are written for humans who browse. Types check individual API calls but can't encode intent. Training data is a snapshot of the ecosystem as it *was*, mixing versions without flagging which one applies. The knowledge gap between your tool and agents using your tool isn't a content problem. It's a lifecycle problem. |
| 13 | +Not because it's dumb — because there's no pipeline between what you know about your tool and what agents know about your tool. Docs are written for humans who browse. Types check individual API calls but can't encode intent. Training data is a snapshot of the ecosystem as it _was_, mixing versions without flagging which one applies. The knowledge gap between your tool and agents using your tool isn't a content problem. It's a lifecycle problem. |
14 | 14 |
|
15 | 15 | ## Skills as side quests |
16 | 16 |
|
@@ -74,7 +74,7 @@ And `intent setup` copies CI workflow templates into your repo so validation run |
74 | 74 | npx intent setup |
75 | 75 | ``` |
76 | 76 |
|
77 | | -This matters because the alternative is hoping model providers eventually re-train on your latest docs. That's not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain *both* versions forever with no mechanism to disambiguate. Skills bypass this entirely. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
| 77 | +This matters because the alternative is hoping model providers eventually re-train on your latest docs. That's not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain _both_ versions forever with no mechanism to disambiguate. Skills bypass this entirely. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
78 | 78 |
|
79 | 79 |  |
80 | 80 |
|
@@ -105,7 +105,7 @@ npx intent meta |
105 | 105 |
|
106 | 106 | ## From skills to playbooks |
107 | 107 |
|
108 | | -A single skill helps an agent use one tool correctly. But real development is composition — routing *with* server state *with* a data grid *with* client-side storage. No individual skill covers how they fit together. |
| 108 | +A single skill helps an agent use one tool correctly. But real development is composition — routing _with_ server state _with_ a data grid _with_ client-side storage. No individual skill covers how they fit together. |
109 | 109 |
|
110 | 110 | Playbooks are the orchestration layer. A developer says "build a paginated data table with URL-synced filters" and the playbook knows which skills to load and how they compose — the search params skill, the loader/query integration skill, the table columnDefs skill, in the right order. Developer goals map to skill combinations. |
111 | 111 |
|
@@ -138,4 +138,4 @@ Skills that keep needing the same workaround are a signal. Sometimes the fix is |
138 | 138 |
|
139 | 139 | We've started rolling out skills in [TanStack DB](https://github.com/TanStack/db/pull/1330) with other TanStack libraries following. If you maintain a library, tell your coding agent to run `npx @tanstack/intent scaffold` and let us know how it goes. We're looking for feedback on the authoring workflow, the skill format, and what's missing. File issues on [GitHub](https://github.com/TanStack/intent) or find us on [Discord](https://tlinz.com/discord). |
140 | 140 |
|
141 | | -The lifecycle is: write your docs, generate skills, ship them with your package, validate and keep them current, learn from how they're used, make your tool better. Repeat. |
| 141 | +The lifecycle is: write your docs, generate skills, ship them with your package, validate and keep them current, learn from how they're used, make your tool better. Repeat. |
0 commit comments