Skip to content

Commit 108da6b

Browse files
KyleAMathewsclaude
andcommitted
fix: correct CLI command spacing and update setup to setup-github-actions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent f7a4dd3 commit 108da6b

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

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

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -52,22 +52,22 @@ That `metadata.sources` field is load-bearing. When those docs change, the CLI f
5252

5353
## Generating and validating skills
5454

55-
You don't author skills from scratch. `@tanstack/intentscaffold` walks you through a guided workflow to generate skills for your library:
55+
You don't author skills from scratch. `@tanstack/intent scaffold` walks you through a guided workflow to generate skills for your library:
5656

5757
```bash
58-
npx @tanstack/intentscaffold
58+
npx @tanstack/intent scaffold
5959
```
6060

61-
The scaffold produces drafts you review, refine, and commit alongside your source code. Once you have skills, `@tanstack/intentvalidate` checks that your skill files are well-formed:
61+
The scaffold produces drafts you review, refine, and commit alongside your source code. Once you have skills, `@tanstack/intent validate` checks that your skill files are well-formed:
6262

6363
```bash
64-
npx @tanstack/intentvalidate
64+
npx @tanstack/intent validate
6565
```
6666

67-
And `@tanstack/intentsetup` copies CI workflow templates into your repo so validation runs automatically on every push:
67+
And `@tanstack/intent setup-github-actions` copies CI workflow templates into your repo so validation runs automatically on every push:
6868

6969
```bash
70-
npx @tanstack/intentsetup
70+
npx @tanstack/intent setup-github-actions
7171
```
7272

7373
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.
@@ -76,27 +76,27 @@ This matters because the alternative is hoping model providers eventually re-tra
7676

7777
## The dependency graph does the discovery
7878

79-
When a developer runs `@tanstack/intentinit`, the CLI discovers every intent-enabled package in their project and wires the relevant skills into their agent configuration — CLAUDE.md, .cursorrules, whatever their tooling expects.
79+
When a developer runs `@tanstack/intent install`, the CLI discovers every intent-enabled package in their project and wires the relevant skills into their agent configuration — CLAUDE.md, .cursorrules, whatever their tooling expects.
8080

8181
```bash
82-
npx @tanstack/intentinit
82+
npx @tanstack/intent install
8383
```
8484

8585
![intent init discovers intent-enabled packages in node_modules and wires skills into agent config](/blog-assets/from-docs-to-agents/diagram-discovery.svg)
8686

87-
No manual setup per-library. No hunting for rules files. Install the package, run `@tanstack/intentinit`, and the agent understands the tool. Update the package, and the skills update with it. Knowledge travels through the same channel as code.
87+
No manual setup per-library. No hunting for rules files. Install the package, run `@tanstack/intent install`, and the agent understands the tool. Update the package, and the skills update with it. Knowledge travels through the same channel as code.
8888

89-
`@tanstack/intentlist` shows you what's available:
89+
`@tanstack/intent list` shows you what's available:
9090

9191
```bash
92-
npx @tanstack/intentlist # See what's intent-enabled in your deps
93-
npx @tanstack/intentlist --json # Machine-readable output
92+
npx @tanstack/intent list # See what's intent-enabled in your deps
93+
npx @tanstack/intent list --json # Machine-readable output
9494
```
9595

96-
For library maintainers, `@tanstack/intentmeta` surfaces meta-skills — higher-level guidance for how to author and maintain skills for your library:
96+
For library maintainers, `@tanstack/intent meta` surfaces meta-skills — higher-level guidance for how to author and maintain skills for your library:
9797

9898
```bash
99-
npx @tanstack/intentmeta
99+
npx @tanstack/intent meta
100100
```
101101

102102
## From skills to playbooks
@@ -111,21 +111,21 @@ The more libraries in your stack that ship skills, the richer the composition st
111111

112112
The real risk with any derived artifact is staleness. You update your docs, ship a new API, and the skills silently drift. `@tanstack/intent` treats this as a first-class problem.
113113

114-
`@tanstack/intentstale` checks your skills for version drift — flagging any that may have fallen behind their source material:
114+
`@tanstack/intent stale` checks your skills for version drift — flagging any that may have fallen behind their source material:
115115

116116
```bash
117-
npx @tanstack/intentstale # Human-readable report
118-
npx @tanstack/intentstale --json # Machine-readable for CI
117+
npx @tanstack/intent stale # Human-readable report
118+
npx @tanstack/intent stale --json # Machine-readable for CI
119119
```
120120

121121
Run it in CI and you get a failing check when source material has changed. The skill becomes part of your release checklist — not something you remember to update, something your pipeline catches.
122122

123123
![The intent lifecycle: docs to skills to npm to agent config, with staleness checks and feedback loops](/blog-assets/from-docs-to-agents/diagram-lifecycle.svg)
124124

125-
The feedback loop runs both directions. `@tanstack/intentfeedback` lets users submit structured reports when a skill produces incorrect output — which skill was active, which version, what went wrong. That context flows back to you as a maintainer, and the fix ships to everyone on the next `npm update`.
125+
The feedback loop runs both directions. `@tanstack/intent feedback` lets users submit structured reports when a skill produces incorrect output — which skill was active, which version, what went wrong. That context flows back to you as a maintainer, and the fix ships to everyone on the next `npm update`.
126126

127127
```bash
128-
npx @tanstack/intentfeedback
128+
npx @tanstack/intent feedback
129129
```
130130

131131
Skills that keep needing the same workaround are a signal. Sometimes the fix is a better skill. Sometimes it's a better API. A skill that dissolves because the tool absorbed its lesson is the system working as intended.

0 commit comments

Comments
 (0)