docs(skills): reflect the SDK-bundled, version-pinned agent reference#3939
docs(skills): reflect the SDK-bundled, version-pinned agent reference#3939ericallam wants to merge 1 commit into
Conversation
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.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
WalkthroughThis PR updates documentation to clarify Skills' installation and versioning model in Trigger.dev. Skills are now described as installed via the CLI into native skills directories with API guidance sourced from a version-pinned reference in 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Warning There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure. 🔧 ESLint
ESLint install timed out. The project may have too many dependencies for the sandbox. Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
🧹 Nitpick comments (1)
docs/skills.mdx (1)
27-27: 💤 Low valueConsider splitting this long sentence for readability.
The sentence runs 52 words and packs four distinct actions (detect, pick, write, add pointer) plus multiple directory/file examples. While accurate, breaking it into 2-3 shorter sentences would improve clarity.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
Run ID: ccd82717-bed8-4896-9100-c81dc63013db
📒 Files selected for processing (3)
docs/building-with-ai.mdxdocs/mcp-agent-rules.mdxdocs/skills.mdx
📜 Review details
🧰 Additional context used
📓 Path-based instructions (1)
docs/**/*.mdx
📄 CodeRabbit inference engine (docs/CLAUDE.md)
docs/**/*.mdx: MDX documentation pages must include frontmatter with title (required), description (required), and sidebarTitle (optional) in YAML format
Use Mintlify components for structured content: , , , , , , /, /
Always import from@trigger.dev/sdkin code examples (never from@trigger.dev/sdk/v3)
Code examples must be complete and runnable where possible
Use language tags in code fences:typescript,bash,json
Files:
docs/skills.mdxdocs/building-with-ai.mdxdocs/mcp-agent-rules.mdx
🧠 Learnings (2)
📚 Learning: 2026-03-10T12:44:14.176Z
Learnt from: nicktrn
Repo: triggerdotdev/trigger.dev PR: 3200
File: docs/config/config-file.mdx:353-368
Timestamp: 2026-03-10T12:44:14.176Z
Learning: In the trigger.dev repo, docs PRs are often companions to implementation PRs. When reviewing docs PRs (MDX files under docs/), check the PR description for any companion/related PR references and verify that the documented features exist in those companion PRs before flagging missing implementations. This ensures docs stay in sync with code changes across related PRs.
Applied to files:
docs/skills.mdxdocs/building-with-ai.mdxdocs/mcp-agent-rules.mdx
📚 Learning: 2026-04-30T20:30:29.458Z
Learnt from: ericallam
Repo: triggerdotdev/trigger.dev PR: 3226
File: docs/ai-chat/quick-start.mdx:13-13
Timestamp: 2026-04-30T20:30:29.458Z
Learning: In this repo’s documentation MDX files (`docs/**/*.mdx`), use `ts` and `tsx` (not `typescript`) as the code-fence language tags for TypeScript/TSX snippets. Do not flag `ts`/`tsx` code-fence language tags as incorrect in any docs MDX file, since this is the site-wide Mintlify-compatible convention.
Applied to files:
docs/skills.mdxdocs/building-with-ai.mdxdocs/mcp-agent-rules.mdx
🪛 LanguageTool
docs/skills.mdx
[uncategorized] ~27-~27: The official name of this software platform is spelled with a capital “H”.
Context: ... (.claude/skills/, .cursor/skills/, .github/skills/, .agents/skills/). It also a...
(GITHUB)
🔇 Additional comments (5)
docs/skills.mdx (3)
21-21: LGTM!
31-31: LGTM!
67-67: LGTM!docs/building-with-ai.mdx (1)
25-25: LGTM!docs/mcp-agent-rules.mdx (1)
14-14: LGTM!
Summary
The agent skills' deep guidance now ships inside
@trigger.dev/sdkand is read fromnode_modules, so it tracks the@trigger.dev/sdkversion installed in your project automatically. This updates 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 and describe the version-pinned reference instead.Pairs with the SDK/CLI change in #3937. Keep this draft until that ships, since it describes behavior that is not released yet.