Uh oh!
There was an error while loading. Please reload this page.
fix(llms-txt): replace dead skills.sentry.dev entry points in llms.txt + SKILL.md - #19183
Conversation
…t + SKILL.md skills.sentry.dev/workflows and /features return 404; the served skill tree only ships flat sentry-* routes. Replaces both dead links (and the /sdks redirect in SKILL.md) with canonical 200-verified paths, in both AGENT_SKILLS (generate-llms-txt.mjs) and SKILL.md. Fixesgetsentry#19182
@wallidsaydi-creator is attempting to deploy a commit to the Sentry Team on Vercel. A member of the Team first needs to authorize it. |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit:8b60fdbd6c
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| - **Feature setup** (AI monitoring, alerts, OTel): https://skills.sentry.dev/features | ||
| - **SDK setup** (detect platform and install): https://skills.sentry.dev/instrument | ||
| - **Debugging workflows** (fix issues, review code): https://skills.sentry.dev/sentry-debug-issue/SKILL.md | ||
| - **Feature setup** (AI monitoring, alerts, OTel): https://skills.sentry.dev/sentry-create-alert/SKILL.md |
There was a problem hiding this comment.
When the plugin is unavailable and an agent selects this entry for AI monitoring or OpenTelemetry, it is sent to the alert-creation skill instead of instructions for the requested feature. The generator already treats OTel as a separate skill at scripts/generate-llms-txt.mjs:194; split this entry into feature-specific links (and provide the corresponding AI-monitoring route) so the repository's routing guide does not misdirect agents.
AGENTS.md reference: AGENTS.md:L100-L102
Useful? React with 👍 / 👎.
Address review feedback: SKILL.md now mirrors the generator's skill list — OTel setup gets its own sentry-otel-exporter-setup entry instead of being conflated with alert creation.
wallidsaydi-creator
commented
Aug 29, 2026
Both review findings addressed in 4d28165:
The |
Summary
Fixes#19182.
docs.sentry.io/llms.txt(L183–186) and the repo-rootSKILL.md(L22–24) direct AI agents to browse the Sentry skill library — but two of the four advertised entry points are dead:https://skills.sentry.dev/https://skills.sentry.dev/instrumenthttps://skills.sentry.dev/workflowshttps://skills.sentry.dev/featuresThe served skill tree no longer contains
workflows/featuresas top-level routes — the current skills are the flatsentry-*set. When a coding agent follows the published "Workflows" / "Features" entry points and hits a bare 404 from Vercel, it either dead-ends or improvises — the exact failure mode llms.txt exists to prevent.This PR replaces both dead links (plus the
/sdks→/instrumentredirect in SKILL.md) with canonical paths that exist today.Changes
scripts/generate-llms-txt.mjs—AGENT_SKILLSblock:[Workflows]/[Features]→[Debug Issues]/[Create Alerts]/[OTel Setup], all pointing at realsentry-*/SKILL.mdroutesSKILL.md— same three-line replacement, additionally fixing/sdks→/instrumentVerification
x-vercel-cache: MISSfrom origin)https://skills.sentry.dev/https://skills.sentry.dev/instrumenthttps://skills.sentry.dev/sentry-debug-issue/SKILL.mdhttps://skills.sentry.dev/sentry-create-alert/SKILL.mdhttps://skills.sentry.dev/sentry-otel-exporter-setup/SKILL.mdAGENT_SKILLSinjection into both outputs (public/llms.txt+public/md-exports/index.md) verified in generator source (assembly at L251/L281)Context
I audit AI-agent tooling and documentation drift. Recent related work: cloudflare/cloudflare-docs#32985 (merged: llms.txt hub link generation fix) and the Codex TOML fix in upstash/context7#3060 (shipped by the maintainer in #3075).
IS YOUR CHANGE URGENT?