Skip to content

Commit 2cc1743

Browse files
authored
docs(skills): note the skills CLI command is only in the release candidate (#4047)
## Summary The `skills` installer command (`npx trigger.dev@latest skills`) ships in the release candidate but is not yet on the stable release, so running it with `@latest` fails today. Adds a warning on each docs page that shows the command, telling users to run it with the `@rc` tag until it lands in `@latest`. The commands themselves stay on `@latest`, so nothing needs reverting once the next stable release ships, just the warnings. Pages updated: - `/skills` - `/mcp-agent-rules` - `/building-with-ai`
1 parent b1987dc commit 2cc1743

3 files changed

Lines changed: 20 additions & 3 deletions

File tree

docs/building-with-ai.mdx

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,11 @@ We provide multiple tools to help AI coding assistants write correct Trigger.dev
2828
npx trigger.dev@latest skills
2929
```
3030

31+
<Warning>
32+
The `skills` command is currently only available in the release candidate. Until it ships to
33+
the stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
34+
</Warning>
35+
3136
[Learn more →](/skills)
3237
</Step>
3338

@@ -41,7 +46,7 @@ Skills and the MCP server do different jobs and work best together. Here's how t
4146
|:--|:-----------|:---------------|
4247
| **What it does** | Drops skill files into your project that teach Trigger.dev patterns | Runs a live server your AI connects to |
4348
| **Installs to** | `.claude/skills/`, `.cursor/skills/`, `.github/skills/`, `.agents/skills/` | `mcp.json`, `~/.claude.json`, etc. |
44-
| **Updates** | Re-run `npx trigger.dev@latest skills`, or auto-prompted on `trigger dev` | Always latest (uses `@latest`) |
49+
| **Updates** | Re-run `npx trigger.dev@latest skills` (`@rc` until it ships to stable), or auto-prompted on `trigger dev` | Always latest (uses `@latest`) |
4550
| **Best for** | Teaching patterns and best practices | Live project interaction (deploy, trigger, monitor) |
4651
| **Works offline** | Yes | No (calls Trigger.dev API) |
4752

docs/mcp-agent-rules.mdx

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,12 @@ The install command is the same, and now installs skills:
1919
npx trigger.dev@latest skills
2020
```
2121

22-
`npx trigger.dev@latest install-rules` still works as an alias, and `trigger dev` offers to install the skills on first run.
22+
<Warning>
23+
The `skills` command is currently only available in the release candidate. Until it ships to the
24+
stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
25+
</Warning>
26+
27+
`npx trigger.dev@latest install-rules` still works as an alias for `skills` (so the same `@rc` caveat applies for now), and `trigger dev` offers to install the skills on first run.
2328

2429
The old task and realtime guidance now lives in the `trigger-authoring-tasks` and `trigger-realtime-and-frontend` skills, alongside two new skills for building `chat.agent` AI agents. See [Skills](/skills) for the full list and supported assistants.
2530

docs/skills.mdx

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,11 @@ Run the installer with the CLI:
2424
npx trigger.dev@latest skills
2525
```
2626

27+
<Warning>
28+
The `skills` command is currently only available in the release candidate. Until it ships to the
29+
stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
30+
</Warning>
31+
2732
The CLI detects your installed AI tools, lets you pick which skills to install, and writes each one into that tool's native skills directory (`.claude/skills/`, `.cursor/skills/`, `.github/skills/`, `.agents/skills/`). It also adds a one-line pointer to your primary instructions file (`CLAUDE.md`, `.cursor/rules`, etc.) so your assistant always knows the skills are there and loads the right one on demand.
2833

2934
When you run `trigger dev` for the first time, the CLI offers to install the skills for you.
@@ -38,6 +43,8 @@ Pass `--target` to choose tools and `-y` to install every skill without promptin
3843
npx trigger.dev@latest skills --target claude-code --target cursor -y
3944
```
4045

46+
While the command is still release-candidate only, swap `@latest` for `@rc`.
47+
4148
## Available skills
4249

4350
| Skill | Use for | Covers |
@@ -65,7 +72,7 @@ Using a tool that does not support skills yet? Select "Unsupported target" in th
6572

6673
## Keeping skills updated
6774

68-
The API guidance updates on its own: it lives in `@trigger.dev/sdk` and is read from `node_modules`, so upgrading the SDK in your project upgrades the guidance with it. Re-run `npx trigger.dev@latest skills` (or accept the prompt that `trigger dev` shows when a newer version is available) only to add skills or refresh the installed pointer files. Re-running overwrites them in place without creating duplicates.
75+
The API guidance updates on its own: it lives in `@trigger.dev/sdk` and is read from `node_modules`, so upgrading the SDK in your project upgrades the guidance with it. Re-run `npx trigger.dev@latest skills` (use `@rc` until the command ships to the stable release, or accept the prompt that `trigger dev` shows when a newer version is available) only to add skills or refresh the installed pointer files. Re-running overwrites them in place without creating duplicates.
6976

7077
## Next steps
7178

0 commit comments

Comments
 (0)