Skip to content

fix(ai): point agent setup prompts at docs markdown URLs - #18897

Draft
sentry-junior[bot] wants to merge 3 commits into
masterfrom
dcramer/ai-setup-use-docs-urls
Draft

fix(ai): point agent setup prompts at docs markdown URLs#18897
sentry-junior[bot] wants to merge 3 commits into
masterfrom
dcramer/ai-setup-use-docs-urls

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Stop using skills.sentry.dev in agent/onboarding setup prompts. Point agents at docs markdown URLs instead (docs.sentry.io/...md).

Changes

  • AgentSetupCallout / CopyPromptButton now build prompts from the current page path or platform docs URL
  • llms.txt generation no longer advertises skills.sentry.dev; it points to docs markdown + plugin install
  • Updated SKILL.md / AGENTS.md routing guidance accordingly

Example prompt now:

Read and follow https://docs.sentry.io/platforms/javascript/guides/cloudflare.md to set up the Sentry Cloudflare SDK.

Test plan

  • On a platform page with AgentSetupCallout, confirm the displayed/copied prompt uses that page's docs .md URL
  • On product getting-started pages with inline Copy Prompt buttons, confirm prompts use the linked platform docs path
  • Confirm scripts/generate-llms-txt.mjs has no skills.sentry.dev references

Notes

  • Companion app PR: getsentry/sentry branch dcramer/ai-setup-use-docs-urls
  • skill prop is retained on callouts for existing analytics only

Requested by David Cramer via Junior.

--

View Junior Session

Replace skills.sentry.dev references in onboarding callouts, llms.txt
generation, and agent routing docs with docs.sentry.io markdown URLs.

Co-Authored-By: David Cramer <david@sentry.io>
@vercel

vercel Bot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview Jul 30, 2026 9:28pm
sentry-docs Ready Ready Preview Jul 30, 2026 9:28pm

Request Review

Point streamed-spans agent-assisted migration prompts at docs.sentry.io
markdown pages instead of sentry-for-ai skill files.

Co-Authored-By: Daniel Griesser <dgriesser@sentry.io>

```txt
Use curl to download, read and follow https://raw.githubusercontent.com/getsentry/sentry-for-ai/refs/heads/main/skills-legacy/sentry-span-streaming-js/SKILL.md to enable and migrate to span streaming in the Sentry SDK.
Read and follow https://docs.sentry.io/platforms/javascript/tracing/streamed-spans.md to enable and migrate to span streaming in the Sentry SDK.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I opened #18906 which replaces the hard-coded URL here with a dynamic one, depending on which sub-guide users are looking at this page (e.g. Node, Express, NextJS, React). This ensures that any differences in this page depending on the selected framework/guide are in the docs, agents will use.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant