Add building with ai/skills pages and updated intro #2962
Conversation
|
WalkthroughAdds a new documentation section "Building with AI" and a new overview page Estimated code review effort🎯 3 (Moderate) | ⏱️ ~20 minutes 🚥 Pre-merge checks | ✅ 2 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (2 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. 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 |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@docs/skills.mdx`:
- Around line 10-15: The installation paths listed are inaccurate for some
tools; update the docs around the "SKILL.md" and "npx skills add
triggerdotdev/skills" section to show correct destination directories (use
~/.cursor/skills/ for Cursor skills, ~/.copilot/skills/ for GitHub Copilot
integration, and keep .claude/skills/ for Claude) or add a short note explaining
when alternative paths are intentionally shown; edit the text that currently
lists `.cursor/rules/` and `.github/copilot-instructions/` to the correct paths
or clarify the multiple installation methods so the CLI behavior is accurately
described.
📜 Review details
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
⛔ Files ignored due to path filters (1)
docs/images/intro-ai.jpgis excluded by!**/*.jpg
📒 Files selected for processing (4)
docs/building-with-ai.mdxdocs/docs.jsondocs/introduction.mdxdocs/skills.mdx
🧰 Additional context used
📓 Path-based instructions (1)
**/*.{js,ts,jsx,tsx,json,md,yaml,yml}
📄 CodeRabbit inference engine (AGENTS.md)
Format code using Prettier before committing
Files:
docs/docs.json
🧠 Learnings (1)
📚 Learning: 2026-01-15T11:50:06.067Z
Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-15T11:50:06.067Z
Learning: Keep the `.claude/skills/trigger-dev-tasks/` skill in sync with the latest rules version when SDK features change
Applied to files:
docs/skills.mdx
🔇 Additional comments (3)
docs/building-with-ai.mdx (1)
1-24: Solid overview page and calls-to-action.Concise copy and clear entry points to MCP Server and Skills.
docs/docs.json (1)
46-55: Navigation update looks coherent.The new “Building with AI” group cleanly organizes the new overview, MCP Server, and Skills pages.
docs/introduction.mdx (1)
19-20: Image assetintro-ai.jpgexists and is correctly referenced. No action needed.
✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.
Update example paths to use correct skill directories: - .cursor/skills/ (not .cursor/rules/) - .github/skills/ (not .github/copilot-instructions/)
Review CompleteYour review story is ready! Comment !reviewfast on this PR to re-generate the story. |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@docs/skills.mdx`:
- Line 10: Update the sentence in docs/skills.mdx to clarify that a "skill" is a
directory that contains a SKILL.md file (not a standalone file): reword the line
"Skills install as `SKILL.md` files..." to something like "Skills are installed
as directories that contain a `SKILL.md` file; each `SKILL.md` includes YAML
frontmatter (name, description) and markdown instructions..." to clearly
distinguish the skill (directory) from the `SKILL.md` file it contains.
📜 Review details
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
docs/skills.mdx
🧰 Additional context used
🧠 Learnings (1)
📚 Learning: 2026-01-15T11:50:06.067Z
Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-15T11:50:06.067Z
Learning: Keep the `.claude/skills/trigger-dev-tasks/` skill in sync with the latest rules version when SDK features change
Applied to files:
docs/skills.mdx
🪛 LanguageTool
docs/skills.mdx
[uncategorized] ~14-~14: The official name of this software platform is spelled with a capital “H”.
Context: ..., .claude/skills/, .cursor/skills/, .github/skills/, etc. ```bash npx skills add ...
(GITHUB)
✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@docs/skills.mdx`:
- Around line 24-36: Update the broken "View all →" link in docs/skills.mdx:
locate the markdown line with the "View all →" anchor and replace the invalid
URL (https://skills.sh/docs/supported-agents) with the correct, live URL for the
supported agents page (e.g., https://skills.sh/supported-agents or the project's
canonical supported-agents docs path) so the link returns 200.
📜 Review details
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
docs/skills.mdx
🧰 Additional context used
🧠 Learnings (1)
📚 Learning: 2026-01-15T11:50:06.067Z
Learnt from: CR
Repo: triggerdotdev/trigger.dev PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-01-15T11:50:06.067Z
Learning: Keep the `.claude/skills/trigger-dev-tasks/` skill in sync with the latest rules version when SDK features change
Applied to files:
docs/skills.mdx
🔇 Additional comments (4)
docs/skills.mdx (4)
1-10: LGTM on the introduction and skills explanation.The frontmatter is well-structured, and the explanation of what agent skills are is clear. Line 10 correctly describes skills as directories containing a
SKILL.mdfile, which addresses the previous review feedback.
38-62: LGTM on the available skills section.The code examples are clear, and the skills table provides a helpful overview of what each skill covers. The recommendation to install
trigger-tasksas a default is sensible guidance for new users.
64-79: LGTM on the next steps section.The CardGroup provides logical navigation to related documentation. The mix of internal links (
/mcp-introduction,/tasks/overview,/guides/ai-agents/overview) and the external link toskills.shis appropriate.
20-20: The attribution is accurate—skillsis indeed an open-source CLI created and maintained by Vercel (Vercel Labs), open-sourced at vercel-labs/skills on GitHub.
✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.
| ## Supported AI assistants | ||
|
|
||
| Skills work with any AI coding assistant that supports the [Agent Skills standard](https://agentskills.io), including: | ||
|
|
||
| - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | ||
| - [Cursor](https://cursor.com) | ||
| - [Windsurf](https://codeium.com/windsurf) | ||
| - [GitHub Copilot](https://github.com/features/copilot) | ||
| - [Cline](https://github.com/cline/cline) | ||
| - [Codex CLI](https://github.com/openai/codex) | ||
| - [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ||
| - [OpenCode](https://opencode.ai) | ||
| - [View all →](https://skills.sh/docs/supported-agents) |
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Verify external URLs are reachable
urls=(
"https://agentskills.io"
"https://docs.anthropic.com/en/docs/claude-code"
"https://cursor.com"
"https://codeium.com/windsurf"
"https://github.com/features/copilot"
"https://github.com/cline/cline"
"https://github.com/openai/codex"
"https://github.com/google-gemini/gemini-cli"
"https://opencode.ai"
"https://skills.sh/docs/supported-agents"
)
for url in "${urls[@]}"; do
status=$(curl -s -o /dev/null -w "%{http_code}" -L --max-time 10 "$url")
echo "$status $url"
doneRepository: triggerdotdev/trigger.dev
Length of output: 429
🌐 Web query:
Verify Codex CLI repository - is github.com/openai/codex the correct repository for Codex CLI?
💡 Result:
Yes. github.com/openai/codex is the official (and primary) GitHub repository for OpenAI’s Codex CLI. The OpenAI developer docs and Help Center both point to openai/codex as the home for Codex CLI development. [1][2][3]
🌐 Web query:
OpenCode AI tool - verify opencode.ai and OpenCode as an AI coding assistant tool
💡 Result:
Yes—opencode.ai appears to be the official website for “OpenCode”, an open-source AI coding agent / coding assistant. It describes OpenCode as an open-source agent usable from the terminal, IDE, or a desktop app; supports connecting many model providers (Claude/GPT/Gemini, etc.); and provides an install script (curl -fsSL …/install | bash). [1]
The project is backed by an active public GitHub repository under the org opencode-ai/opencode, describing OpenCode as a Go-based terminal AI assistant (TUI) with multi-provider model support, session management, tool/file integration, and LSP features. [2]
It also has official docs for GitHub workflow integration, where commenting /opencode (or /oc) triggers actions on a GitHub Actions runner, and it references an official GitHub App (github.com/apps/opencode-agent). [3]
Caution (name collisions): there are other unrelated repositories also named “opencode” on GitHub (different owners), so for “OpenCode” specifically, match the site opencode.ai with the GitHub org opencode-ai and the GitHub App mentioned in the official docs. [2] [3]
Sources:
[1] opencode.ai (homepage)
[2] GitHub: opencode-ai/opencode
[3] opencode.ai docs: GitHub integration / GitHub App installation
🌐 Web query:
Agent Skills standard support - which AI coding assistants support the Agent Skills standard
💡 Result:
AI coding assistants with documented support for the Agent Skills (SKILL.md) standard include:
- Anthropic Claude Code (loads skills from
~/.claude/skills/and.claude/skills/). [1] - OpenAI Codex (Codex CLI + Codex IDE extensions) via “Agent Skills”. [2]
- GitHub Copilot:
- Copilot in VS Code (Agent Skills; preview in VS Code Insiders) [3]
- The same VS Code doc also states the standard works across GitHub Copilot CLI and GitHub Copilot coding agent. [3]
- OpenCode (supports
SKILL.mdskills; also reads Claude-compatible paths). [4] - Amp (supports
SKILL.mdskills in.agents/skills//~/.config/agents/skills/and is compatible with.claude/skills/). [5]
Note: ChatGPT is not “native” for Agent Skills in the same way as Codex/Claude Code—common guidance is to use Custom Instructions to paste skill content manually. [6]
Sources: [1] [2] [3] [4] [5] [6]
Fix broken "View all" link.
The "View all →" link at line 36 (https://skills.sh/docs/supported-agents) returns a 404 error and should be updated to a valid URL. All other external URLs verify successfully (200 status), and the Codex CLI and OpenCode tool references are correct.
🤖 Prompt for AI Agents
In `@docs/skills.mdx` around lines 24 - 36, Update the broken "View all →" link in
docs/skills.mdx: locate the markdown line with the "View all →" anchor and
replace the invalid URL (https://skills.sh/docs/supported-agents) with the
correct, live URL for the supported agents page (e.g.,
https://skills.sh/supported-agents or the project's canonical supported-agents
docs path) so the link returns 200.
Closes #
✅ Checklist
Testing
[Describe the steps you took to test this change]
Changelog
[Short description of what has changed]
Screenshots
[Screenshots]
💯