|
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 | Your docs are good. Your types are solid. Your agent still gets it wrong. |
10 | 10 |
|
11 | | -Not because it's dumb — because no pipeline connects what you know about your tool to what agents know. Docs target humans who browse. Types check individual API calls but can't encode intent. Training data snapshots the ecosystem as it *was*, mixing versions without flagging which one applies. The gap isn't content. It's lifecycle. |
| 11 | +Not because it's dumb — because no pipeline connects what you know about your tool to what agents know. Docs target humans who browse. Types check individual API calls but can't encode intent. Training data snapshots the ecosystem as it _was_, mixing versions without flagging which one applies. The gap isn't content. It's lifecycle. |
12 | 12 |
|
13 | 13 | ## Skills as side quests |
14 | 14 |
|
@@ -72,7 +72,7 @@ npx intent validate |
72 | 72 | npx intent setup |
73 | 73 | ``` |
74 | 74 |
|
75 | | -The alternative — hoping model providers re-train on your latest docs — is not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain *both* versions forever with no way to disambiguate. Skills bypass this entirely. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
| 75 | +The alternative — hoping model providers re-train on your latest docs — is not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain _both_ versions forever with no way to disambiguate. Skills bypass this entirely. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
76 | 76 |
|
77 | 77 |  |
78 | 78 |
|
@@ -103,7 +103,7 @@ npx intent meta |
103 | 103 |
|
104 | 104 | ## From skills to playbooks |
105 | 105 |
|
106 | | -A single skill helps an agent use one tool correctly. But real development demands composition — routing *with* server state *with* a data grid *with* client-side storage. No individual skill covers how they fit together. |
| 106 | +A single skill helps an agent use one tool correctly. But real development demands composition — routing _with_ server state _with_ a data grid _with_ client-side storage. No individual skill covers how they fit together. |
107 | 107 |
|
108 | 108 | Playbooks are the orchestration layer. A developer says "build a paginated data table with URL-synced filters" and the playbook loads the right skills in the right order — search params, loader/query integration, table columnDefs. Developer goals map to skill combinations. |
109 | 109 |
|
@@ -138,4 +138,4 @@ Devtool makers have a new surface to maintain. You used to ship code, docs, and |
138 | 138 |
|
139 | 139 | Tools that invest here will produce developers who build confidently from day one — not through tutorials or toy projects, but through correct patterns absorbed in the context of real work. |
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