Skip to content

Commit f331e04

Browse files
committed
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.
1 parent 034058b commit f331e04

3 files changed

Lines changed: 6 additions & 11 deletions

File tree

docs/building-with-ai.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ We provide multiple tools to help AI coding assistants write correct Trigger.dev
2222
</Step>
2323

2424
<Step title="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 CLI into 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`.
2626

2727
```bash
2828
npx trigger.dev@latest skills

docs/mcp-agent-rules.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ sidebarTitle: "Agent rules"
1111

1212
## What changed
1313

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

1616
The install command is the same, and now installs skills:
1717

docs/skills.mdx

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,17 @@ Each skill is a directory containing a `SKILL.md` file: YAML frontmatter (name,
1818

1919
## Installation
2020

21-
The skills ship inside the `trigger.dev` CLI and are versioned with it. Run:
21+
Run the installer with the CLI:
2222

2323
```bash
2424
npx trigger.dev@latest skills
2525
```
2626

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

2929
When you run `trigger dev` for the first time, the CLI offers to install the skills for you.
3030

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

3833
### Non-interactive install
3934

@@ -69,7 +64,7 @@ Using a tool that does not support skills yet? Select "Unsupported target" in th
6964

7065
## Keeping skills updated
7166

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

7469
## Next steps
7570

0 commit comments

Comments
 (0)