docs(skills): note the skills CLI command is only in the release candidate by D-K-P · Pull Request #4047 · triggerdotdev/trigger.dev

D-K-P · 2026-06-25T16:56:37Z

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

@rc

…idate The skills installer ships in the release candidate but is not yet on the stable release. Add a warning on each page that shows the command, telling users to run it with the @rc tag until it lands in @latest.

changeset-bot · 2026-06-25T16:56:43Z

⚠️ No Changeset found

Latest commit: 28ffdd5

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

coderabbitai · 2026-06-25T16:57:46Z

Caution

Review failed

An error occurred during the review process. Please try again later.

Walkthrough

The documentation now describes agent rules as skills installed with the skills command, notes install-rules as an alias, and adds release-candidate warnings in the related setup guides. The warnings direct readers to use npx trigger.dev@rc skills until the command is available in stable.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description has a summary, but it omits the required issue reference, checklist, testing, changelog, and screenshots sections.	Add the template sections: Closes #, checklist, testing steps, changelog, and screenshots, or mark unused sections N/A.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly states the docs update about the skills CLI being RC-only and matches the main change.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch docs-skills-rc-not-released

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.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

coderabbitai

Actionable comments posted: 3

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 40435acc-ec51-41ce-bbe1-c7609f69c5b6

📥 Commits

Reviewing files that changed from the base of the PR and between f163c89 and 5f2d16d.

📒 Files selected for processing (3)

docs/building-with-ai.mdx
docs/mcp-agent-rules.mdx
docs/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/sdk in 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/building-with-ai.mdx
docs/skills.mdx
docs/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/building-with-ai.mdx
docs/skills.mdx
docs/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/building-with-ai.mdx
docs/skills.mdx
docs/mcp-agent-rules.mdx

coderabbitai · 2026-06-25T17:03:50Z

+  <Warning>
+    The `skills` command is currently only available in the release candidate. Until it ships to
+    the stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
+  </Warning>


🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Make the example match the warning.

The warning says skills is RC-only, but the install snippet above still uses npx trigger.dev@latest skills. Anyone copying it will land on the wrong release channel until stable. Switch the example to @rc for now.

🔧 Suggested fix

- npx trigger.dev@latest skills + npx trigger.dev@rc skills

coderabbitai · 2026-06-25T17:03:50Z

+<Warning>
+  The `skills` command is currently only available in the release candidate. Until it ships to the
+  stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
+</Warning>


🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Make the example match the warning.

The warning says skills is RC-only, but the snippet above still shows npx trigger.dev@latest skills. Readers copying this will hit the wrong release channel until stable. Switch the example to @rc for now.

🔧 Suggested fix

- npx trigger.dev@latest skills + npx trigger.dev@rc skills

coderabbitai · 2026-06-25T17:03:50Z

+<Warning>
+  The `skills` command is currently only available in the release candidate. Until it ships to the
+  stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
+</Warning>


🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Make the example match the warning.

The warning says skills is RC-only, but the example above still uses npx trigger.dev@latest skills. Readers copying the snippet will hit the wrong channel until stable. Switch the example to @rc for now.

🔧 Suggested fix

- npx trigger.dev@latest skills + npx trigger.dev@rc skills

@rc

…ences Cover the non-interactive install example, the keeping-updated section, and the comparison table so users who deep-link past the install section still see the @rc note.

devin-ai-integration

Devin Review found 1 new potential issue.

devin-ai-integration · 2026-06-26T09:22:12Z

+  stable release, run it with the `@rc` tag: `npx trigger.dev@rc skills`.
+</Warning>
+
 `npx trigger.dev@latest install-rules` still works as an alias, and `trigger dev` offers to install the skills on first run.


🚩 Pre-existing install-rules alias reference may confuse users given the new RC warning

In docs/mcp-agent-rules.mdx:27, the pre-existing (unchanged) line states "npx trigger.dev@latest install-rules still works as an alias". The new warning at lines 22-25 says the skills command is RC-only. Since install-rules is registered as an alias for skills (packages/cli-v3/src/commands/skills.ts:59), running npx trigger.dev@latest install-rules would also fail if @latest doesn't include the skills command yet. This is a pre-existing line that the PR didn't modify, but the newly added warning above it creates a potential contradiction that could confuse readers. Consider adding a parenthetical note to line 27 or adjusting it to mention @rc as well.

Was this helpful? React with 👍 or 👎 to provide feedback.

This comment was marked as resolved.

Sign in to view

coderabbitai Bot reviewed Jun 25, 2026

View reviewed changes

docs(skills): add the RC caveat to the remaining skills command refer…

28ffdd5

…ences Cover the non-interactive install example, the keeping-updated section, and the comparison table so users who deep-link past the install section still see the @rc note.

devin-ai-integration Bot reviewed Jun 26, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

docs(skills): note the skills CLI command is only in the release candidate#4047

docs(skills): note the skills CLI command is only in the release candidate#4047
D-K-P wants to merge 2 commits into
mainfrom
docs-skills-rc-not-released

D-K-P commented Jun 25, 2026

Uh oh!

changeset-bot Bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jun 25, 2026 •

edited

Loading

Review failed

❌ Failed checks (1 warning)

Uh oh!

This comment was marked as resolved.

Uh oh!

coderabbitai Bot left a comment

Uh oh!

coderabbitai Bot Jun 25, 2026

Uh oh!

coderabbitai Bot Jun 25, 2026

Uh oh!

coderabbitai Bot Jun 25, 2026

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

devin-ai-integration Bot Jun 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

D-K-P commented Jun 25, 2026

Summary

Uh oh!

changeset-bot Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

coderabbitai Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

This comment was marked as resolved.

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot Jun 25, 2026

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot Jun 25, 2026

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot Jun 25, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot Jun 26, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

changeset-bot Bot commented Jun 25, 2026 •

edited

Loading

coderabbitai Bot commented Jun 25, 2026 •

edited

Loading