Skip to content

Commit 955de55

Browse files
ci: apply automated fixes
1 parent c07de63 commit 955de55

File tree

2 files changed

+7
-7
lines changed

2 files changed

+7
-7
lines changed

src/blog/from-docs-to-agents.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
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'
33
published: 2026-03-04
44
authors:
55
- Sarah Gerrard
6-
- Kyle Matthews
6+
- Kyle Matthews
77
---
88

99
![From Docs to Agents](/blog-assets/from-docs-to-agents/header.png)
1010

1111
Your docs are good. Your types are solid. Your agent still gets it wrong.
1212

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.
1414

1515
## Skills as side quests
1616

@@ -74,7 +74,7 @@ And `intent setup` copies CI workflow templates into your repo so validation run
7474
npx intent setup
7575
```
7676

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.
7878

7979
![Model training data mixes versions permanently vs. skills pinned to your installed version](/blog-assets/from-docs-to-agents/diagram-split-brain.svg)
8080

@@ -105,7 +105,7 @@ npx intent meta
105105

106106
## From skills to playbooks
107107

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.
109109

110110
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.
111111

@@ -138,4 +138,4 @@ Skills that keep needing the same workaround are a signal. Sometimes the fix is
138138

139139
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).
140140

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.

src/libraries/libraries.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -591,7 +591,7 @@ export const intent: LibrarySlim = {
591591
to: '/intent',
592592
tagline: 'Developer Infrastructure for AI-Ready Libraries',
593593
description:
594-
'A toolkit for shipping composable, agent-readable knowledge alongside your npm packages. Automatic discovery from node_modules, distributed architecture where skills live in each library\'s repo, and seamless compatibility across package managers.',
594+
"A toolkit for shipping composable, agent-readable knowledge alongside your npm packages. Automatic discovery from node_modules, distributed architecture where skills live in each library's repo, and seamless compatibility across package managers.",
595595
badge: 'alpha',
596596
bgStyle: 'bg-sky-500',
597597
borderStyle: 'border-sky-500/50',

0 commit comments

Comments
 (0)