You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(skills): reflect the SDK-bundled, version-pinned agent reference
The deep agent guidance now ships inside @trigger.dev/sdk and is read from
node_modules, so it tracks the installed SDK version. Update the Skills page, the
Building with AI step, and the rules-redirect page to drop the old "pinned to the
CLI version, re-run to refresh" framing.
Copy file name to clipboardExpand all lines: docs/building-with-ai.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ We provide multiple tools to help AI coding assistants write correct Trigger.dev
22
22
</Step>
23
23
24
24
<Steptitle="Install Skills">
25
-
Portable instruction sets that teach any AI coding assistant Trigger.dev best practices: writing tasks, realtime frontends, and `chat.agent` AI agents. They ship with the CLI, versioned with it, and install into Claude Code, Cursor, VS Code (Copilot), and AGENTS-compatible tools such as Codex via `.agents/skills/`.
25
+
Portable instruction sets that teach any AI coding assistant Trigger.dev best practices: writing tasks, realtime frontends, and `chat.agent` AI agents. They install with the CLIinto Claude Code, Cursor, VS Code (Copilot), and AGENTS-compatible tools such as Codex via `.agents/skills/`, and draw their API guidance from a version-pinned reference shipped in `@trigger.dev/sdk`.
Copy file name to clipboardExpand all lines: docs/mcp-agent-rules.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ sidebarTitle: "Agent rules"
11
11
12
12
## What changed
13
13
14
-
Trigger.dev used to install per-tool *rule files* (`.cursor/rules/trigger.*.mdc`, regions in `CLAUDE.md`, and so on) fetched from GitHub. That has been replaced by [agent skills](/skills): `SKILL.md` directories in the open [Agent Skills standard](https://agentskills.io) that ship inside the CLI, versioned with it, and load on demand instead of always sitting in your context.
14
+
Trigger.dev used to install per-tool *rule files* (`.cursor/rules/trigger.*.mdc`, regions in `CLAUDE.md`, and so on) fetched from GitHub. That has been replaced by [agent skills](/skills): `SKILL.md` directories in the open [Agent Skills standard](https://agentskills.io) that install with the CLI, draw their API guidance from a version-pinned reference in `@trigger.dev/sdk`, and load on demand instead of always sitting in your context.
15
15
16
16
The install command is the same, and now installs skills:
Copy file name to clipboardExpand all lines: docs/skills.mdx
+4-9Lines changed: 4 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,22 +18,17 @@ Each skill is a directory containing a `SKILL.md` file: YAML frontmatter (name,
18
18
19
19
## Installation
20
20
21
-
The skills ship inside the `trigger.dev` CLI and are versioned with it. Run:
21
+
Run the installer with the CLI:
22
22
23
23
```bash
24
24
npx trigger.dev@latest skills
25
25
```
26
26
27
-
The CLI detects your installed AI tools, lets you pick which skills to install, and copies each one into that tool's native skills directory (`.claude/skills/`, `.cursor/skills/`, `.github/skills/`, `.agents/skills/`). It also writes a one-line pointer into 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.
27
+
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.
28
28
29
29
When you run `trigger dev` for the first time, the CLI offers to install the skills for you.
30
30
31
-
<Note>
32
-
Because the skills are bundled with the CLI, the guidance your assistant gets is pinned to the CLI
33
-
version that installs them. To keep it matched to the Trigger.dev version you are building
34
-
against, run the CLI pinned in your project (`pnpm exec trigger skills`) instead of
35
-
`npx trigger.dev@latest`.
36
-
</Note>
31
+
The installed skills are lightweight. Most point to the full, version-pinned reference that ships inside `@trigger.dev/sdk`, which your assistant reads straight from `node_modules`. The API guidance it follows always matches the `@trigger.dev/sdk` version installed in your project, with no extra step on your part. The `getting-started` skill is self-contained, since it runs before the SDK is installed.
37
32
38
33
### Non-interactive install
39
34
@@ -69,7 +64,7 @@ Using a tool that does not support skills yet? Select "Unsupported target" in th
69
64
70
65
## Keeping skills updated
71
66
72
-
Skills are pinned to your installed CLI version. To refresh them after upgrading Trigger.dev, run `npx trigger.dev@latest skills`again, or accept the prompt that `trigger dev` shows when a newer version is available. Re-running overwrites the installed skill files in place without creating duplicates.
67
+
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.
0 commit comments